Как сделать свой MCP-сервер?

Свой MCP-сервер проще всего написать на официальном SDK: для Python — пакет mcp с классом FastMCP, для TypeScript — @modelcontextprotocol/sdk; есть SDK и для Java, Kotlin, C# и других языков. Вы описываете функции-инструменты с понятными названиями и параметрами, запускаете сервер через stdio и прописываете команду запуска в конфигурации клиента. Проверить сервер до подключения можно в MCP Inspector.

Обновлено

Подробно

Минимальный путь на Python

  1. Создайте проект и добавьте зависимость: uv add "mcp[cli]".
  2. Создайте сервер: mcp = FastMCP("notes").
  3. Опишите инструмент функцией с декоратором @mcp.tool(): имя, параметры с типами и docstring — модель читает это описание.
  4. Запустите: mcp.run(transport="stdio").
  5. Пропишите команду запуска в конфигурации клиента (например, в mcp.json редактора).
Важно

Главная ошибка новичков

В сервере, который работает через stdio, нельзя писать в стандартный вывод: print() в Python или console.log() в Node.js ломают обмен сообщениями JSON-RPC, и клиент перестаёт понимать сервер. Логи пишите в stderr или в файл.

Описания

Как сделать инструменты понятными модели

Пошагово

Как сделать

  1. Выберите язык и установите официальный SDK.
  2. Опишите 1–3 инструмента под реальную задачу.
  3. Запустите сервер через stdio и проверьте в MCP Inspector (npx @modelcontextprotocol/inspector).
  4. Подключите к клиенту через его конфигурацию и проверьте вызовы на живых вопросах.
Важно

Что важно знать

Вопросы

Частые вопросы по теме

На каком языке писать MCP-сервер?

На том, где у вас уже есть код интеграции: официальные SDK есть для популярных языков.

Можно ли сделать удалённый сервер?

Да, через HTTP-транспорт; тогда понадобится авторизация.

Источники

Источники