mcp-server-toolkit

Готовый к промышленному использованию стартовый набор для серверов Model Context Protocol с аутентификацией, трассировкой и системой плагинов.

Создано Sarma Linux.

Что это такое

В конце 2025 года MCP превратился из нишевой спецификации в стандартный уровень интеграции. Теперь на нем «говорят» все серьезные агенты. Большинство эталонных серверов — это игрушки: один инструмент, никакой аутентификации, никакой наблюдаемости. Этот набор инструментов — альтернатива с «батарейками в комплекте» и четким мнением о том, как все должно работать.

Разверните MCP-сервер одной командой. Добавляйте обработчики инструментов в директорию плагинов. Получите OAuth 2.1 с PKCE, структурированное логирование, трассировку OpenTelemetry, ограничение частоты запросов (rate limiting) и типизированный реестр инструментов бесплатно. Работает через stdio для локальных агентов и через потоковый HTTP для удаленных, используя один и тот же код.

Архитектура

graph TD
  Client[MCP Client<br/>Desktop / Cursor / IDE]
  Client -->|stdio JSON-RPC| Stdio[stdio transport]
  Client -->|streamable HTTP| HTTP[FastAPI HTTP transport]
  Stdio --> Reg[Tool Registry]
  HTTP --> Auth[OAuth 2.1 / API key]
  Auth --> Reg
  Reg --> P1[plugin: filesystem]
  Reg --> P2[plugin: postgres]
  Reg --> P3[plugin: github]
  Reg --> P4[plugin: sarmalink]
  P4 -->|api.sarmalink.ai| SLAI[SarmaLink-AI]

  classDef ext fill:#a78bfa,stroke:#a78bfa,color:#fff
  class SLAI ext

Быстрый старт

git clone https://github.com/sarmakska/mcp-server-toolkit.git
cd mcp-server-toolkit
uv sync
cp .env.example .env
uv run mcp-toolkit run --transport stdio

Создание плагинов

from mcp_toolkit.registry import registry

@registry.tool("search_docs", description="Search internal docs")
async def search_docs(query: str) -> dict:
    return {"results": [...]}

Конфигурация

Развертывание

Distroless Docker-образ, ~120 МБ. Работает на Fly.io, Render, Railway, k8s.

docker build -t mcp-toolkit .
docker run -p 8000:8000 --env-file .env mcp-toolkit

Дорожная карта

См. docs/OPEN-ISSUES.md. Пул-реквесты приветствуются.

Лицензия

MIT.

Создано Sarma Linux.