Как написать собственный MCP-сервер?

Model Context Protocol (MCP) — это открытый стандарт, который описывает, как LLM-приложение (клиент) общается с внешними источниками данных и инструментами (серверами). Идея проста: вместо того чтобы встраивать каждую интеграцию прямо в чат-бота, вы выносите её в отдельный процесс — MCP-сервер, который умеет отвечать на стандартные запросы: «какие у тебя есть инструменты», «вызови инструмент X с такими аргументами», «дай ресурс Y».

Из чего состоит MCP-сервер

• Transport — канал связи: stdio (локальный процесс) или HTTP+SSE (удалённый сервер).
• Capabilities — что сервер умеет: tools, resources, prompts, sampling, roots.
• Handlers — функции, которые вы регистрируете под каждый инструмент или ресурс.
• JSON-RPC 2.0 — формат сообщений между клиентом и сервером.

Минимальный пример на TypeScript

Официальный SDK @modelcontextprotocol/sdk берёт на себя транспорт и валидацию, вам остаётся описать инструменты.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "weather", version: "1.0.0" });

server.tool(
  "get_weather",
  "Возвращает погоду по городу",
  { city: z.string() },
  async ({ city }) => ({
    content: [{ type: "text", text: `Погода в ${city}: +18C` }],
  })
);

await server.connect(new StdioServerTransport());

Как это работает на практике

1. Клиент запускает ваш сервер (например, через node server.js) и устанавливает stdio-соединение.
2. Клиент отправляет initialize, сервер отвечает своими capabilities.
3. Клиент вызывает tools/list и получает описание инструментов.
4. Когда модель решает вызвать инструмент, клиент шлёт tools/call с аргументами.
5. Сервер выполняет логику и возвращает результат в формате content-блоков.

Подключение к клиенту

В Claude Desktop или другом MCP-клиенте сервер прописывается в конфиге:

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/server.js"]
    }
  }
}

Для удалённых серверов используется HTTP-транспорт с SSE, а также OAuth для авторизации. Важно валидировать входные аргументы (zod, pydantic) и не выполнять опасные операции без подтверждения — модель может ошибиться.

Итог: собственный MCP-сервер стоит писать, когда нужно дать LLM доступ к вашим данным, API или внутренним инструментам без изменения самого клиента — это стандартизированный и переносимый способ интеграции.