آموزش / پیشرفته: ساختن با API / درس ۱۳ از ۱۵
MCP چیست؟ وصل کردن ایجنت به ابزارها و دادهها
پروتکل MCP به ایجنتها اجازه میدهد با دیتابیس، سرویس ابری یا هر ابزار دیگری کار کنند. تنظیم یک سرور آماده، نمونهی سرور MCP آروانکلاد و ساخت یک سرور کوچک با پایتون.
پیشرفته، ۹ دقیقه مطالعه
در این آموزش
MCP (Model Context Protocol) یک استاندارد باز است برای اینکه ابزارهای هوش مصنوعی بهشکل یکسان به منابع بیرونی وصل شوند. بهجای اینکه هر ایجنت برای هر سرویس افزونهی جدا بخواهد، سرویس یک سرور MCP ارائه میکند و هر کلاینت MCP (Claude Code، Cursor، VS Code، OpenCode و…) میتواند از آن استفاده کند.
سرور MCP سه چیز در اختیار ایجنت میگذارد:
- ابزارها: کارهایی که ایجنت میتواند انجام دهد؛ مثل «کوئری روی دیتابیس» یا «ساخت سرور ابری».
- منابع: دادههایی که میتواند بخواند؛ مثل فایلها یا جدولها.
- پرامپتها: دستورهای آماده برای کارهای تکراری.
دو نوع سرور
- محلی: برنامهای که روی سیستم شما اجرا میشود و از راه ورودی و خروجی استاندارد با ایجنت حرف میزند. برای فایلها و ابزارهای محلی.
- راه دور: سرویسی روی اینترنت با نشانی HTTP. برای سرویسهای ابری.
افزودن یک سرور آماده
در Claude Code میتوانید سرور را در فایل .mcp.json ریشهی پروژه تعریف کنید تا برای همهی اعضای تیم در دسترس باشد. نمونه: سرور فایلسیستم که فقط به یک پوشه دسترسی دارد:
{
"mcpServers": {
"docs": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
}
}
}ساختار مشابهی در Cursor (فایل .cursor/mcp.json) و بسیاری از کلاینتهای دیگر استفاده میشود.
نمونهی ایرانی: MCP Server آروانکلاد
آروانکلاد یک سرور MCP راه دور منتشر کرده که با آن میتوانید سرویسهای آروان را با زبان طبیعی از Cursor، Claude یا OpenCode مدیریت کنید. طبق مستندات آروان، نشانی سرور https://mcp.arvancloud.ir است و کلید API در سرآیند Arvancloud-Api-Key فرستاده میشود. یک تنظیم نمونه برای سرور راه دور:
{
"mcpServers": {
"arvan": {
"type": "http",
"url": "https://mcp.arvancloud.ir",
"headers": { "Arvancloud-Api-Key": "YOUR_ARVAN_API_KEY" }
}
}
}جزئیات و مجموعهابزارهای فعال را در مستندات MCP آروان ببینید. این کلید به زیرساخت شما دسترسی میدهد؛ برایش کمترین سطح دسترسی لازم را تعریف کنید.
ساخت یک سرور MCP کوچک با پایتون
با SDK رسمی پایتون، ساختن یک سرور ساده چند خط است. این سرور یک ابزار دارد که دلار را با نرخ ثابت به تومان تبدیل میکند:
# pip install mcp
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("toman-tools")
@mcp.tool()
def usd_to_toman(usd: float, rate: float) -> str:
"""Convert a US dollar amount to Toman with the given exchange rate."""
return f"{usd * rate:,.0f} Toman"
if __name__ == "__main__":
mcp.run()و برای معرفی به Claude Code:
{
"mcpServers": {
"toman": { "command": "python", "args": ["server.py"] }
}
}توضیح (docstring) هر ابزار مهم است: مدل از روی همین متن تصمیم میگیرد کی و چطور ابزار را صدا بزند.
نکتههای امنیتی
- فقط سرورهای منتشرکنندههای معتبر را نصب کنید؛ سرور MCP روی سیستم شما کد اجرا میکند.
- دسترسی هر سرور را محدود کنید: یک پوشه، یک دیتابیس فقطخواندنی، یک کلید با مجوز کم.
- دادهای که سرور برمیگرداند ممکن است حاوی تزریق دستور باشد؛ برای کارهای پرخطر تأیید دستی بخواهید.