Files
2026-07-13 13:31:35 +08:00

125 lines
7.3 KiB
Markdown

# మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్ (MCP) పైథాన్ అమలు
ఈ రిపోజిటరీలో మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్ (MCP) యొక్క పైథాన్ అమలు ఉంది, ఇది MCP ప్రమాణాన్ని ఉపయోగించి కమ్యూనికేట్ చేసే సర్వర్ మరియు క్లయింట్ అప్లికేషన్‌లను ఎలా సృష్టించాలో చూపిస్తుంది.
## అవలోకనం
MCP అమలు రెండు ప్రధాన భాగాలుగా ఉంటుంది:
1. **MCP సర్వర్ (`server.py`)** - ఒక సర్వర్ ఇది అందిస్తుంది:
- **టూల్స్**: రిమోట్‌గా పిలవగల ఫంక్షన్లు
- **రిసోర్సెస్**: పొందగలిగే డేటా
- **ప్రాంప్ట్స్**: భాషా మోడల్స్ కోసం ప్రాంప్ట్‌లను సృష్టించే టెంప్లేట్లు
2. **MCP క్లయింట్ (`client.py`)** - సర్వర్‌కు కనెక్ట్ అయ్యి దాని ఫీచర్లను ఉపయోగించే క్లయింట్ అప్లికేషన్
## ఫీచర్లు
ఈ అమలు కొన్ని ముఖ్యమైన MCP ఫీచర్లను చూపిస్తుంది:
### టూల్స్
- `completion` - AI మోడల్స్ నుండి టెక్స్ట్ కంప్లీషన్స్ సృష్టిస్తుంది (సిమ్యులేటెడ్)
- `add` - రెండు సంఖ్యలను జోడించే సింపుల్ క్యాల్క్యులేటర్
### రిసోర్సెస్
- `models://` - అందుబాటులో ఉన్న AI మోడల్స్ గురించి సమాచారం ఇస్తుంది
- `greeting://{name}` - ఇచ్చిన పేరుకు వ్యక్తిగతీకరించిన అభివాదం ఇస్తుంది
### ప్రాంప్ట్స్
- `review_code` - కోడ్ సమీక్ష కోసం ప్రాంప్ట్ సృష్టిస్తుంది
## ఇన్‌స్టాలేషన్
ఈ MCP అమలును ఉపయోగించడానికి, అవసరమైన ప్యాకేజీలను ఇన్‌స్టాల్ చేయండి:
```powershell
pip install mcp-server mcp-client
```
## సర్వర్ మరియు క్లయింట్ నడపడం
### సర్వర్ ప్రారంభించడం
ఒక టెర్మినల్ విండోలో సర్వర్ నడపండి:
```powershell
python server.py
```
MCP CLI ఉపయోగించి డెవలప్‌మెంట్ మోడ్‌లో కూడా సర్వర్ నడపవచ్చు:
```powershell
mcp dev server.py
```
లేదా Claude Desktopలో ఇన్‌స్టాల్ చేసి నడపవచ్చు (ఉపలబ్ధి ఉంటే):
```powershell
mcp install server.py
```
### క్లయింట్ నడపడం
మరొక టెర్మినల్ విండోలో క్లయింట్ నడపండి:
```powershell
python client.py
```
ఇది సర్వర్‌కు కనెక్ట్ అయి అందుబాటులో ఉన్న అన్ని ఫీచర్లను ప్రదర్శిస్తుంది.
### క్లయింట్ ఉపయోగం
క్లయింట్ (`client.py`) అన్ని MCP సామర్థ్యాలను చూపిస్తుంది:
```powershell
python client.py
```
ఇది సర్వర్‌కు కనెక్ట్ అయి టూల్స్, రిసోర్సెస్, ప్రాంప్ట్స్ సహా అన్ని ఫీచర్లను ఉపయోగిస్తుంది. అవుట్‌పుట్ లో చూపిస్తుంది:
1. క్యాల్క్యులేటర్ టూల్ ఫలితం (5 + 7 = 12)
2. "What is the meaning of life?" అనే ప్రశ్నకు కంప్లీషన్ టూల్ స్పందన
3. అందుబాటులో ఉన్న AI మోడల్స్ జాబితా
4. "MCP Explorer" కోసం వ్యక్తిగత అభివాదం
5. కోడ్ సమీక్ష ప్రాంప్ట్ టెంప్లేట్
## అమలు వివరాలు
సర్వర్ `FastMCP` API ఉపయోగించి అమలు చేయబడింది, ఇది MCP సర్వీసులను నిర్వచించడానికి ఉన్నత స్థాయి అభిసరణలను అందిస్తుంది. టూల్స్ ఎలా నిర్వచించబడతాయో సాదారణ ఉదాహరణ ఇక్కడ ఉంది:
```python
@mcp.tool()
def add(a: int, b: int) -> int:
"""Add two numbers together
Args:
a: First number
b: Second number
Returns:
The sum of the two numbers
"""
logger.info(f"Adding {a} and {b}")
return a + b
```
క్లయింట్ MCP క్లయింట్ లైబ్రరీ ఉపయోగించి సర్వర్‌కు కనెక్ట్ అయి కాల్ చేస్తుంది:
```python
async with stdio_client(server_params) as (reader, writer):
async with ClientSession(reader, writer) as session:
await session.initialize()
result = await session.call_tool("add", arguments={"a": 5, "b": 7})
```
## మరింత తెలుసుకోండి
MCP గురించి మరింత సమాచారం కోసం సందర్శించండి: https://modelcontextprotocol.io/
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**అస్పష్టత**:
ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలోనే అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారితీసే అర్థాలు కోసం మేము బాధ్యత వహించము.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->