MCP: एक सर्वर लिखें और जोड़ें
इस सेक्शन के अंत तक आप अपना खुद का MCP सर्वर लिख चुके होंगे, जिसे myagent ढूंढकर उसके टूल्स की खोज करेगा और कॉल करेगा। साथ ही आप समझ जाएंगे कि MCP असल में किस समस्या को हल करता है।
पहले समस्या देखें: हर टूल जोड़ने पर दोबारा लिखना पड़ता है
पिछले अध्याय में हमने टूल्स agent.py में लिखे थे। लेकिन अगर आप चाहते हैं कि Claude Code, Cursor और आपका अपना Agent सब कंपनी के नोट्स डेटाबेस को खोज सकें, तो तीन जगहों पर अलग-अलग लिखना होगा, और फॉर्मैट भी अलग-अलग होंगे।
MCP (Model Context Protocol) इसी समस्या को हल करने के लिए है: टूल एक बार लिखें, एक MCP सर्वर बनाएं, और MCP सपोर्ट करने वाले सभी प्रोग्राम उसे सीधे इस्तेमाल कर सकेंगे। आधिकारिक उपमा है: MCP, AI ऐप्स के लिए USB-C पोर्ट जैसा है।
तीन भूमिकाएं
खोजेंMCP के अंदर की चीज़ें…
एक पर क्लिक करके देखें।
सर्वर तीन तरह की चीज़ें दे सकता है: Tools (वे फंक्शन जिन्हें मॉडल तय करता है कि कब कॉल करना है), Resources (वह डेटा जिसे ऐप पढ़ता है), Prompts (वे प्रॉम्प्ट टेम्पलेट जिन्हें यूज़र चुनता है)। इस सेक्शन में सिर्फ Tools का उपयोग होगा। मैसेज फॉर्मैट JSON-RPC 2.0 है; एक टूल कॉल नेटवर्क पर ऐसा दिखता है (स्पेसिफिकेशन मूल पाठ):
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call",
"params": { "name": "get_weather", "arguments": { "location": "New York" } } }1. एक MCP सर्वर लिखें
mcp_servers/notes_server.py (myagent.zip में):
import json
from pathlib import Path
from mcp.server import MCPServer
NOTES = Path(__file__).with_name("notes.json")
mcp = MCPServer("notes")
def _load():
return json.loads(NOTES.read_text(encoding="utf-8")) if NOTES.exists() else []
@mcp.tool()
def add_note(text: str) -> str:
"""记下一条笔记。"""
notes = _load() + [text]
NOTES.write_text(json.dumps(notes, ensure_ascii=False), encoding="utf-8")
return f"已记下,共 {len(notes)} 条。"
@mcp.tool()
def search_notes(keyword: str) -> list[str]:
"""按关键词查找笔记,返回所有包含这个词的笔记。"""
return [n for n in _load() if keyword in n]
if __name__ == "__main__":
mcp.run()पिछले अध्याय में JSON Schema हाथ से लिखने के उलट, यहां टाइप एनोटेशन ही schema है: text: str SDK को बताता है कि पैरामीटर स्ट्रिंग है, और फंक्शन की डॉकस्ट्रिंग ही टूल का विवरण है। mcp.run() पैरामीटर नहीं लेता, यानी यह stdio (स्टैंडर्ड इनपुट/आउटपुट) से क्लाइंट से बात करता है।
इंटरनेट पर कई ट्यूटोरियलों का FastMCP नए संस्करण में अब काम नहीं करता
आधिकारिक Python SDK ने 2.x से FastMCP का नाम बदलकर MCPServer कर दिया, और पुराना इंपोर्ट पाथ सीधे हटा दिया गया है। पुराने ट्यूटोरियल के मुताबिक from mcp.server.fastmcp import FastMCP लिखने पर ModuleNotFoundError: No module named 'mcp.server.fastmcp' एरर आएगा, और एरर मैसेज में from mcp.server.mcpserver import MCPServer इस्तेमाल करने की सलाह होगी। हम mcp 2.3.0 (2026-10-02 रिलीज़) इस्तेमाल कर रहे हैं। पुराना कोड चलाना चाहें तो mcp<2 इंस्टॉल करें।
2. Agent को उससे जोड़ें
MCP SDK 2.x में क्लाइंट के पास सिर्फ एक Client क्लास है। इसे एक StdioServerParameters दें, तो यह सर्वर को सबप्रोसेस के रूप में शुरू करेगा और stdio से जुड़ जाएगा:
async def connect_mcp(command, stack):
from mcp import Client
from mcp.client.stdio import StdioServerParameters
parts = shlex.split(command)
mcp_client = await stack.enter_async_context(Client(StdioServerParameters(command=parts[0], args=parts[1:])))
listed = await mcp_client.list_tools()
tools = [{"type": "function", "function": {"name": t.name, "description": t.description or "",
"parameters": t.input_schema}} for t in listed.tools]
return mcp_client, toolsमुख्य कदम: MCP सर्वर द्वारा सूचीबद्ध टूल्स (नाम, विवरण, इनपुट schema) को मॉडल की पहचान वाले tools फ़ॉर्मैट में बदलना, और उन्हें लोकल टूल्स के साथ मिलाकर मॉडल को देना। जब मॉडल कॉल करने का अनुरोध करे, तो अगर वह लोकल टूल नहीं है, तो उसे MCP को भेज दें:
r = await mcp_client.call_tool(name, args)
result = "\n".join(getattr(c, "text", str(c)) for c in r.content)चलाएँ:
python agent.py --mcp "python mcp_servers/notes_server.py" "记一条笔记:周五下午三点和设计组评审消息通知的交互稿"
python agent.py --mcp "python mcp_servers/notes_server.py" "我记过哪些和设计组有关的事?"आपको यह दिखना चाहिए (इस मशीन पर qwen3:8b का वास्तविक आउटपुट):
MCP सर्वर से कनेक्ट हो गया, नए टूल्स: add_note, search_notes
[1] add_note({"text": "शुक्रवार दोपहर तीन बजे डिज़ाइन टीम के साथ मैसेज नोटिफिकेशन के इंटरैक्शन ड्राफ़्ट की समीक्षा"})
Agent: नोट दर्ज किया गया: शुक्रवार दोपहर तीन बजे डिज़ाइन टीम के साथ मैसेज नोटिफिकेशन के इंटरैक्शन ड्राफ़्ट की समीक्षा।MCP सर्वर से कनेक्ट हो गया, नए टूल्स: add_note, search_notes
[1] search_notes({"keyword": "डिज़ाइन टीम"})
Agent: डिज़ाइन टीम से संबंधित निम्नलिखित नोट्स मिले:
- शुक्रवार दोपहर तीन बजे डिज़ाइन टीम के साथ मैसेज नोटिफिकेशन के इंटरैक्शन ड्राफ़्ट की समीक्षाmyagent के कोड में नोट्स के बारे में एक भी लाइन नहीं है, सभी टूल्स MCP सर्वर से आए हैं। यही notes_server.py को Claude Code जैसे MCP को सपोर्ट करने वाले अन्य प्रोग्रामों के लिए भी कॉन्फ़िगर किया जा सकता है।
एक आम ग़लती: stdio तरीक़े से शुरू होने वाला सर्वर सबप्रोसेस ** आपके सभी एनवायरनमेंट वेरिएबल्स इनहेरिट नहीं करता **, केवल HOME, PATH जैसे कुछ ही। अगर सर्वर को API Key चाहिए, तो उसे StdioServerParameters(env={...}) में स्पष्ट रूप से पास करना होगा।
3. नए संस्करण की स्पेसिफ़िकेशन में क्या बदला
MCP का वर्श़न नंबर एक तारीख़ है, जो आख़िरी बैकवर्ड-इनकॉम्पैटिबल बदलाव दर्शाता है। वर्तमान वर्श़न 2026-07-28 है, और पिछला 2025-11-25 था। इस संस्करण में बड़े बदलाव हुए हैं:
- प्रोटोकॉल स्टेटलेस हो गया:
initializeहैंडशेक हटा दिया गया, हर अनुरोध अपने साथ वर्श़न और क्षमताओं की जानकारी लाता है; लागू करना अनिवार्यserver/discoverजोड़ा गया। - Streamable HTTP में अब सेशन ID नहीं है।
- Roots, Sampling, Logging — तीनों फ़ीचर्स को डेप्रिकेटेड चिह्नित किया गया है।
इसलिए इंटरनेट पर "पहले initialize हैंडशेक करें" समझाने वाले ट्यूटोरियल पुराने संस्करण की बात कर रहे हैं। SDK से कोड लिखते समय इन बदलावों का एहसास लगभग नहीं होता, SDK आपके लिए संभाल लेता है।
MCP अब Linux Foundation के अंतर्गत Agentic AI Foundation (AAIF) के प्रोजेक्ट्स में से एक है।
4. सुरक्षा: MCP टूल्स यानी दूसरों का कोड
स्पेसिफ़िकेशन में साफ़ लिखा है: टूल का मतलब है आर्बिट्रेरी कोड निष्पादित करना, होस्ट को किसी भी टूल को कॉल करने से पहलेउपयोगकर्ता की स्पष्ट सहमति लेनी ही होगी; टूल के विवरण को, जब तक वे भरोसेमंद सर्वर से न आएं, अविश्वसनीय माना जाना चाहिए। केवल वही MCP सर्वर जोड़ें जिन पर आप भरोसा करते हैं। हमारे myagent ने सरलता के लिए MCP टूल्स पर पुष्टि नहीं जोड़ी है, आख़िरी अध्याय में बताया जाएगा कि इसे कैसे जोड़ा जाए।
आपकी परीक्षाMCP किस मुख्य समस्या का समाधान है?
जाँच करें
- मैंने notes_server.py लिखा, और myagent को
--mcpके ज़रिए कनेक्ट करवाया - मुझे पता है कि FastMCP का नाम SDK 2.x में MCPServer हो गया है
- मैं 2026-07-28 संस्करण की स्पेसिफ़िकेशन के सबसे बड़े बदलाव बता सकता हूँ
अगला अनुभाग: MCP, Function Calling, A2A और Skills में अंतर।