modular-mcp

Модульный MCP-сервер с аддонами в стиле Odoo (__manifest__.toml) и опциональным веб-слоем на FastAPI.

Установка

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
copy .env.example .env

Конфигурация в основном задается в config.toml. Переменные окружения по-прежнему переопределяют настройки FastAPI (поддерживается .env).

Related MCP server: mcp-app

Запуск

modular-mcp serve
modular-mcp mcp serve
modular-mcp get hello

• Интерфейс FastAPI: http://127.0.0.1:8000/

• MCP по умолчанию: streamable-http на http://127.0.0.1:5001 (см. config.toml)

Адоны

Каждый аддон — это папка в каталоге addons/ следующего вида:

addons/my_addon/
  __manifest__.toml
  config.toml
  tools.py          # register_tools(mcp, config, logger)

Пример аддона: addons/key_value_store/ с kv_get / kv_set.

Общие импорты внутри аддонов:

from app.mcp.utils import format_json, exception_to_error_response
from app.mcp.logging import monitor_performance
from helpers import my_helper  # local module in the same addon folder

Перенос инструмента из dynamic-mcp

# Before
tools/requests_tools.py

# After
addons/requests/
  __manifest__.toml
  config.toml
  tools.py

Перенесите код инструента в tools.py, замените импорты utils.* на app.mcp.utils и укажите log_key в __manifest__.toml.

Тестирование и линт

pytest
ruff check .
ruff format --check .
mypy
pyright

Pre-commit

pip install -e ".[dev]"
pre-commit install
pre-commit run --all-files