125 lines
7.3 KiB
Markdown
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 --> |