mcp-server-starter

Каркас для создания сервера протокола контекста модели (MCP) на Python. Используйте этот репозиторий как основу, когда вам нужно предоставить набор пользовательских инструментов или данных для Claude Desktop, Claude Code или любого другого MCP-совместимого клиента.

Что такое MCP-сервер?

MCP — это открытый протокол, который позволяет клиентам языковых моделей обращаться к внешним инструментам и источникам данных через стандартный интерфейс. MCP-сервер — это небольшой процесс, который размещает эти инструменты: вы пишете функции, а протокол берет на себя их обнаружение и вызов.

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

Установите напрямую из этого репозитория с помощью pipx:

pipx install git+https://github.com/roderickch01/mcp-server-starter.git

Затем зарегистрируйте его в своем MCP-клиенте. Для Claude Desktop отредактируйте файл ~/.config/Claude/claude_desktop_config.json (Linux), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows) и добавьте:

{
  "mcpServers": {
    "starter": {
      "command": "mcp-server-starter"
    }
  }
}

Копия этого фрагмента находится в examples/claude_desktop_config.json. Перезапустите клиент, и инструменты echo и add должны появиться.

Что включено

Два демонстрационных инструмента для проверки работоспособности:

echo(text: str) -> str — возвращает "echo: {text}"
add(a: int, b: int) -> int — возвращает сумму

Оба находятся в src/mcp_server_starter/server.py (менее 30 строк).

Добавление собственного инструмента

Откройте server.py и добавьте декоратор @mcp.tool() к любой функции. Сигнатура, подсказки типов и строка документации автоматически станут схемой инструмента:

@mcp.tool()
def reverse(text: str) -> str:
    """Return the input string reversed."""
    return text[::-1]

Переустановите (pipx reinstall mcp-server-starter) и перезапустите ваш MCP-клиент. Новый инструмент станет доступен.

Локальная разработка

git clone https://github.com/roderickch01/mcp-server-starter.git
cd mcp-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-server-starter   # runs the server over stdio