modular-mcp

Modularer MCP-Server mit Odoo-artigen Addons (__manifest__.toml) plus einer optionalen FastAPI-Webschicht.

Setup

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

Die Konfiguration erfolgt hauptsächlich in config.toml. Umgebungsvariablen überschreiben weiterhin FastAPI-Einstellungen (.env wird unterstützt).

Related MCP server: mcp-app

Ausführen

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

• FastAPI-UI: http://127.0.0.1:8000/

• MCP-Standard: streamable-http unter http://127.0.0.1:5001 (siehe config.toml)

Addons

Jedes Addon ist ein Ordner unter addons/ mit:

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

Beispiel-Addon: addons/key_value_store/ mit kv_get / kv_set.

Gemeinsame Importe in Addons:

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

Portiere ein Tool von dynamic-mcp

# Before
tools/requests_tools.py

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

Verschiebe den Tool-Code in tools.py, ändere die utils.*-Importe zu app.mcp.utils und setze log_key in __manifest__.toml.

Test & Lint

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

Pre-commit

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