Как сделать свой MCP-сервер?
Свой MCP-сервер проще всего написать на официальном SDK: для Python — пакет mcp с классом FastMCP, для TypeScript — @modelcontextprotocol/sdk; есть SDK и для Java, Kotlin, C# и других языков. Вы описываете функции-инструменты с понятными названиями и параметрами, запускаете сервер через stdio и прописываете команду запуска в конфигурации клиента. Проверить сервер до подключения можно в MCP Inspector.
Обновлено
Минимальный путь на Python
- Создайте проект и добавьте зависимость: uv add "mcp[cli]".
- Создайте сервер: mcp = FastMCP("notes").
- Опишите инструмент функцией с декоратором @mcp.tool(): имя, параметры с типами и docstring — модель читает это описание.
- Запустите: mcp.run(transport="stdio").
- Пропишите команду запуска в конфигурации клиента (например, в mcp.json редактора).
Главная ошибка новичков
В сервере, который работает через stdio, нельзя писать в стандартный вывод: print() в Python или console.log() в Node.js ломают обмен сообщениями JSON-RPC, и клиент перестаёт понимать сервер. Логи пишите в stderr или в файл.
Как сделать инструменты понятными модели
- Название — глагол и объект: search_tasks, create_note.
- Описание отвечает на вопрос «когда это вызывать», а не только «что делает».
- Параметры с типами и примерами; лишние параметры убирайте.
- Результат короткий и структурированный: модели не нужен весь ответ API.
- Опасные действия (удаление, отправка) — отдельными инструментами, чтобы клиент мог требовать подтверждение.
Как сделать
- Выберите язык и установите официальный SDK.
- Опишите 1–3 инструмента под реальную задачу.
- Запустите сервер через stdio и проверьте в MCP Inspector (npx @modelcontextprotocol/inspector).
- Подключите к клиенту через его конфигурацию и проверьте вызовы на живых вопросах.
Что важно знать
- Подключайте только серверы из надёжных источников: MCP-сервер может выполнять код на вашем компьютере и читать файлы, а инструменты, которые что-то меняют, стоит подтверждать вручную.
- Ключи API передавайте через переменные окружения в конфигурации клиента, а не в коде сервера.
Частые вопросы по теме
На каком языке писать MCP-сервер?
На том, где у вас уже есть код интеграции: официальные SDK есть для популярных языков.
Можно ли сделать удалённый сервер?
Да, через HTTP-транспорт; тогда понадобится авторизация.
Источники
Похожие вопросы
Как работает MCP-сервер?
MCP (Model Context Protocol) — открытый протокол, по которому ИИ-приложение получает доступ к внешним данным и…
02Как подключить MCP-сервер к ИИ-клиенту?
MCP-сервер подключают через конфигурационный файл клиента, почти всегда в одном формате: объект mcpServers, где у…
03Как подключить MCP-серверы в Cursor?
В Cursor MCP-серверы описываются в файле mcp.json: глобальный — ~/.cursor/mcp.json (для всех проектов), проектный …
04Что такое MCP и зачем он нужен?
MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-ассистенты подключаются к внешним данным и…
05Как подключить MCP-сервер в LM Studio к локальной модели?
LM Studio поддерживает MCP начиная с версии 0.3.17 — и локальные, и удалённые серверы. Откройте вкладку «Program» в…
06Есть ли MCP-сервер для Jira и Confluence?
Да, у Atlassian есть официальный удалённый MCP-сервер: он подключает Jira, Confluence, Jira Service Management…