modular-mcp

Servidor MCP modular con complementos al estilo de Odoo (__manifest__.toml) y una capa web opcional de FastAPI.

Configuración

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

La configuración se encuentra principalmente en config.toml. Las variables de entorno aún pueden sobrescribir los ajustes de FastAPI (se admite .env).

Related MCP server: mcp-app

Ejecutar

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

• Interfaz web de FastAPI: http://127.0.0.1:8000/

• MCP por defecto: streamable-http en http://127.0.0.1:5001 (ver config.toml)

Complementos

Cada complemento es una carpeta dentro de addons/ con:

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

Ejemplo de complemento: addons/key_value_store/ con kv_get / kv_set.

Importaciones compartidas dentro de los complementos:

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

Portar una herramienta desde dynamic-mcp

# Before
tools/requests_tools.py

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

Mueve el código de la herramienta a tools.py, cambia las importaciones de utils.* por app.mcp.utils y define log_key en __manifest__.toml.

Pruebas y lint

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

Pre-commit

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