برو به محتوای اصلی

سرور MCP اختصاصی

برای ادغام‌های پیشرفته می‌توانید یک سرور MCP اختصاصی بسازید. این کار کنترل کامل بر کارکرد را فراهم می‌کند و برای ادغام با سامانه‌های خود یا برنامه‌های پشتیبانی‌نشده ایده‌آل است.

چه زمانی به یک سرور MCP اختصاصی نیاز دارید؟​

یک سرور MCP اختصاصی مناسب است وقتی که:

  • می‌خواهید با یک برنامه یا پایگاه داده اختصاصی ادغام کنید
  • ادغام مطلوب در Zapier در دسترس نیست
  • الزامات امنیتی مشخصی دارید
  • در ابزارها به منطق پیچیده‌ای نیاز دارید

دانش مورد نیاز​

برای ساخت یک سرور MCP اختصاصی به موارد زیر نیاز دارید:

  • تجربه برنامه‌نویسی (TypeScript/JavaScript یا Python)
  • آشنایی با REST APIs
  • دانش پایه از سرورها و میزبانی

پروتکل مدل Context​

پروتکل Context مدل (MCP) یک استاندارد باز است که توسط Anthropic توسعه یافته است. سرورهای MCP می‌توانند با:

  • AI School
  • ChatGPT
  • Claude
  • Visual Studio Code با Copilot
  • سایر برنامه‌های سازگار با MCP

همکاری کنند.

راه‌اندازی سریع با TypeScript​

1. ایجاد پروژه​

mkdir mijn-mcp-server
cd mijn-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk

2. کد سرور​

import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

const server = new Server({
  name: "mijn-server",
  version: "1.0.0",
});

// تعریف ابزارهای شما
server.setRequestHandler("tools/list", async () => ({
  tools: [
    {
      name: "mijn_tool",
      description: "شرح ابزار که چه کاری انجام می‌دهد",
      inputSchema: {
        type: "object",
        properties: {
          parameter: {
            type: "string",
            description: "یک پارامتر",
          },
        },
        required: ["parameter"],
      },
    },
  ],
}));

// پیاده‌سازی ابزار
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "mijn_tool") {
    const { parameter } = request.params.arguments;
    // انجام کاری با پارامتر
    return {
      content: [{ type: "text", text: `نتیجه: ${parameter}` }],
    };
  }
});

// راه‌اندازی سرور
const transport = new StdioServerTransport();
server.connect(transport);

3. اجرای سرور​

npx ts-node server.ts

ترابارد HTTP برای AI School​

AI School از سرورهای MCP از طریق HTTP پشتیبانی می‌کند. سرور شما باید نقطه پایانی ارائه دهد که پیام‌های MCP را بپذیرد:

import express from 'express';

const app = express();
app.use(express.json());

app.post('/mcp', async (req, res) => {
  const { method, params } = req.body;

  if (method === 'tools/list') {
    res.json({ tools: [...] });
  } else if (method === 'tools/call') {
    // پردازش صدا زدن ابزار
    res.json({ content: [...] });
  }
});

app.listen(3000);

گزینه‌های میزبانی​

سرور MCP شما باید از طریق اینترنت در دسترس باشد:

گزینهمناسب برایهزینه
Cloudflare Workersبارکاری سبکسطح رایگان در دسترس است
Vercelسرورهای TypeScriptسطح رایگان در دسترس است
Railwayبرنامه‌های کاملاز 5 دلار در ماه شروع می‌شود
AWS Lambdaراه‌حل‌های مقیاس‌پذیربا استفاده پرداخت می‌شود
سرور خودتانکنترل کاملمتغیر

ارتباط با AI School​

  1. سرور خود را به یک URL عمومی منتشر کنید
  2. به داشبورد در AI School بروید
  3. روی ارتباطات → افزودن اتصال کلیک کنید
  4. URL سرور MCP خود را وارد کنید
  5. هرگونه احراز هویت را پیکربندی کنید

احراز هویت​

می‌توانید به سرور MCP خود احراز هویت اضافه کنید:

احراز هویت کلید API​

app.post("/mcp", (req, res, next) => {
  const apiKey = req.headers["x-api-key"];
  if (apiKey !== process.env.API_KEY) {
    return res.status(401).json({ error: "Unauthorized" });
  }
  next();
});

در AI School گزینه "API Key" را به عنوان روش احراز هویت انتخاب کنید.

OAuth 2.0​

برای احراز هویت پیچیده‌تر می‌توانید OAuth 2.0 را پیاده‌سازی کنید. AI School از OAuth 2.1 برای سرورهای MCP پشتیبانی می‌کند.

نمونه‌ها و منابع​

سرورهای MCP رسمی​

مستندات​

نکات توسعه​

  1. شروع ساده: با یک ابزار آغاز کنید و بعدها گسترش دهید
  2. آزمایش محلی: از MCP Inspector برای اشکابی استفاده کنید
  3. لاگ‌گیری: لاگ‌گذاری گسترده اضافه کنید تا عیب‌یابی آسان شود
  4. مدیریت خطا: خطاهای روشن بازگردانید
  5. نرخ‌بندی: از بارگذاری بیش از حد سرور جلوگیری کنید

ادغام‌های رایج​

سیستمابزارهای ممکن
LVS (Magister, Somtoday)دریافت نمرات، دیدن برنامه‌های درس
سیستم‌های CRMدریافت اطلاعات مشتری، افزودن یادداشت‌ها
پایگاه‌های دادهاجرای کوئری، ایجاد گزارش
برنامه‌های اختصاصیهر API که می‌خواهید درب آن را باز کنید

مقالات مرتبط​