mcp-agent-kit

Чистая реализация сервера Model Context Protocol (MCP) и инструментальной обвязки на стандартной библиотеке для Claude Desktop, Cursor и флотилий автономных агентов.

Быстрый старт • Архитектура • Настройка Claude Desktop • Сравнение • Инженерная строгость

Архитектура

Related MCP server: MCP-123

Почему mcp-agent-kit?

Официальные MCP SDK привносят десятки тяжёлых сторонних зависимостей (pydantic, anyio, httpx, starlette), создавая излишние поверхности атак через цепочку поставок и препятствия при установке в корпоративных средах.

mcp-agent-kit предоставляет полную, готовую к эксплуатации реализацию Model Context Protocol с использованием 100% стандартной библиотеки Python:

• 🚀 Ноль зависимостей времени выполнения: Чистый Python (json, sys, inspect, dataclasses).

• 🔒 Готовность для предприятий: Мгновенная проверяемость при полном отсутствии уязвимостей пакетов.

• ⚡ Сверхлёгкий: Субмиллисекундное время запуска — идеально для CLI-инструментов, serverless-сред и встраиваемых интеграций агентов, развёрнутых непосредственно у клиента.

• 🛠️ Автоматическая генерация схем: Выводит определения JSON Schema напрямую из нативных подсказок типов Python и docstring.

mcp-agent-kit против официального MCP SDK

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

1. Создайте MCP-сервер в 20 строк

from mcp_agent_kit import MCPServer

app = MCPServer(name="my-agent-tools", version="1.0.0")

@app.tool(description="Calculate tax and total invoice amounts")
def calculate_invoice(subtotal: float, tax_rate: float = 0.07) -> dict:
    tax = round(subtotal * tax_rate, 2)
    return {"subtotal": subtotal, "tax": tax, "total": round(subtotal + tax, 2)}

if __name__ == "__main__":
    app.run_stdio()

Интеграция с Claude Desktop

Добавьте ваш сервер напрямую в claude_desktop_config.json:

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["-m", "examples.simple_server"]
    }
  }
}

Перезапустите Claude Desktop, и ваши пользовательские инструменты немедленно появятся в наборе инструментов Claude! 🔨

Возможности

• Полное рукопожатие MCP: initialize, notifications/initialized, ping.

• Динамическое обнаружение инструментов: tools/list с автоматической генерацией JSON Schema.

• Надёжные границы ошибок: tools/call изолирует исключения времени выполнения инструментов и отправляет структурированные сообщения об ошибках обратно в LLM, не вызывая сбоя процесса stdio.

• Ноль зависимостей: Работает из коробки на Python 3.10+.

Инженерная строгость и верификация

• Тесты: набор тестов pytest со 100% прохождением, покрывающий инициализацию, обнаружение инструментов, проверку аргументов и обработку исключений.

• Зависимости: 0 зависимостей времени выполнения.

• Автор: Reuben Bowlby — LinkedIn | Резюме

Корпоративный масштаб

mcp-agent-kit является частью экосистемы разработчиков HUMMBL. Для корпоративного управления мультиагентными системами (четырёхступенчатые аварийные выключатели, токены делегирования с HMAC-подписью и криптографические шины аудита) посетите github.com/hummbl-io.