إعداد بيئة تطوير MCP الخاصة بك

دعنا نُعد كل ما تحتاجه لبناء واختبار خوادم MCP.

المتطلبات المسبقة

قبل البدء، تأكد من وجود:

• Python 3.10+ أو Node.js 18+
• Claude Desktop (للاختبار)
• محرر كود (VS Code موصى به)

تثبيت MCP SDK

تتوفر SDKs رسمية لـ MCP للغات Python وTypeScript وC# وJava وKotlin وSwift. وتتوفر SDKs من المجتمع للغات Rust وGo وغيرها. في هذه الدورة سنستخدم Python وTypeScript، لكن المفاهيم تنطبق مباشرة على أي SDK.

Python SDK

# إنشاء بيئة افتراضية
python -m venv mcp-env
source mcp-env/bin/activate  # على Windows: mcp-env\Scripts\activate

# تثبيت MCP SDK
pip install mcp

TypeScript SDK

# إنشاء مشروع جديد
mkdir my-mcp-server && cd my-mcp-server
npm init -y

# تثبيت MCP SDK
npm install @modelcontextprotocol/sdk

أول خادم MCP لك (Python)

أنشئ ملفاً باسم server.py:

from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

# إنشاء نسخة الخادم
server = Server(name="hello-mcp")

# تعريف أداة بسيطة
@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="greet",
            description="تحية شخص بالاسم",
            inputSchema={
                "type": "object",
                "properties": {
                    "name": {"type": "string", "description": "الاسم للتحية"}
                },
                "required": ["name"]
            }
        )
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "greet":
        return [TextContent(type="text", text=f"مرحباً، {arguments['name']}!")]
    raise ValueError(f"أداة غير معروفة: {name}")

# تشغيل الخادم
async def main():
    async with stdio_server() as (read, write):
        await server.run(read, write)

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

تكوين Claude Desktop

أضف خادمك إلى ملف تكوين Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hello-mcp": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}

اختبار خادمك

1. أعد تشغيل Claude Desktop
2. افتح محادثة جديدة
3. اسأل كلود: "استخدم أداة التحية لقول مرحباً لأليس"
4. سيستدعي كلود خادم MCP الخاص بك!

مشاكل الإعداد الشائعة

المشكلة	الحل
الخادم لا يظهر	تحقق من مسار التكوين، أعد تشغيل كلود
Python غير موجود	استخدم المسار الكامل: /usr/bin/python3
تم رفض الإذن	تحقق من صلاحيات الملف

في القسم التالي، سنتعمق في بناء خوادم MCP حقيقية بأدوات وموارد. :::