بناء خادم MCP مخصص لأول مرة

الخوادم العامة في MCP تغطي الأنظمة الواضحة. الخادم الذي يغير يومك هو الخادم الذي تكتبه بنفسك فقط: الجسر إلى واجهة برمجتك الداخلية، أدوات نشرك، مستودع بيانات المؤسسة.

الخادم الأصغر الفعّال

خادم MCP هو عملية تتحدث البروتوكول على قناة نقل وتكشف الأدوات. الحد الأدنى: أعلن عن أداة، اوصف مدخلاتها، أرجع نتيجة.

// server.ts — exposes one tool over stdio
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
const server = new McpServer({ name: 'ops-tools', version: '1.0.0' })

server.tool('deploy_status', { service: 'string' }, async ({ service }) => {
  const res = await fetch(`https://internal.api/status/${service}`)
  return { content: [{ type: 'text', text: await res.text() }] }
})

server.connect() // stdio

صله:

claude mcp add ops-tools -- node ./server.ts

قواعد التصميم التي تحافظ على سلامته

• أداة واحدة، وظيفة واحدة. أداة deploy_status أفضل من أداة غامضة ops. الأسماء الواضحة تساعد العامل على الاختيار الصحيح.
• اوصف المدخلات بدقة. الـ schema هو دليل تعليمات العامل — المخططات الغامضة تسبب استدعاءات خاطئة.
• اقرأ قبل الكتابة. وزّع أدوات للقراءة فقط أولاً؛ أضف أدوات التعديل فقط بعد أن تثق في الحلقة، واحفظها مسمّاة بوضوح.

إرجاع مخرجات جيدة

الأدوات ترجع نصاً يقرأه العامل. أرجع مخرجات منظمة موجزة (JSON أو ملخص محكم)، وليس كتلة من السجلات. العامل يفكر فيما تعيده؛ الضوضاء على الدخل تعني ضوضاء على الخرج.

مع خادم من صنعك، العامل يصل إلى عالمك. بعده نتأكد أنه يتصرف دائماً في هذا العالم — مع hooks.