مقدمة في MCP: دليل البدء السريع للمبتدئين

# إنشاء مجلد المشروع
mkdir mcp-hello-world
cd mcp-hello-world
 
# تهيئة مشروع Node.js
npm init -y

# تثبيت MCP SDK و Zod للتحقق
npm install @modelcontextprotocol/sdk zod
 
# تثبيت تبعيات تطوير TypeScript
npm install -D typescript @types/node

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "declaration": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

{
  "name": "mcp-hello-world",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node build/index.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^0.5.0",
    "zod": "^3.22.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.0.0"
  }
}

mkdir src

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
import { z } from "zod";
 
// تعريف مخطط التحقق لأداتنا
const GreetingSchema = z.object({
  name: z.string().describe("اسم الشخص للترحيب به"),
});
 
// إنشاء نسخة خادم MCP
const server = new Server(
  {
    name: "hello-world-server",
    version: "1.0.0",
  },
  {
    capabilities: {
      tools: {},
    },
  }
);
 
// المعالج: سرد الأدوات المتاحة
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      {
        name: "greet",
        description: "توليد تحية ودية لشخص",
        inputSchema: {
          type: "object",
          properties: {
            name: {
              type: "string",
              description: "اسم الشخص للترحيب به",
            },
          },
          required: ["name"],
        },
      },
      {
        name: "get_current_time",
        description: "الحصول على التاريخ والوقت الحاليين",
        inputSchema: {
          type: "object",
          properties: {},
          required: [],
        },
      },
    ],
  };
});
 
// المعالج: تنفيذ استدعاءات الأدوات
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;
 
  if (name === "greet") {
    const { name: personName } = GreetingSchema.parse(args);
    const greeting = `مرحباً، ${personName}! أهلاً بك في عالم MCP.`;
 
    return {
      content: [
        {
          type: "text",
          text: greeting,
        },
      ],
    };
  }
 
  if (name === "get_current_time") {
    const now = new Date();
    const timeString = now.toLocaleString("ar-SA", {
      weekday: "long",
      year: "numeric",
      month: "long",
      day: "numeric",
      hour: "2-digit",
      minute: "2-digit",
      second: "2-digit",
    });
 
    return {
      content: [
        {
          type: "text",
          text: `الوقت الحالي هو: ${timeString}`,
        },
      ],
    };
  }
 
  throw new Error(`أداة غير معروفة: ${name}`);
});
 
// الدالة الرئيسية لبدء الخادم
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error("خادم MCP Hello World يعمل الآن!");
}
 
main().catch((error) => {
  console.error("خطأ فادح:", error);
  process.exit(1);
});

npm run build

npm start

{
  "mcpServers": {
    "hello-world": {
      "command": "node",
      "args": ["/المسار/المطلق/إلى/mcp-hello-world/build/index.js"]
    }
  }
}