modular-mcp

Modular MCP server with Odoo-style addons (__manifest__.toml) plus an optional FastAPI web layer.

Setup

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

Configuration is primarily in config.toml. Environment variables still override FastAPI settings (.env supported).

Source	Purpose
config.toml	MCP server, logging, addon paths, FastAPI defaults
.env / env vars	Override FastAPI HOST, PORT, LOG_LEVEL, etc.

Run

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

• FastAPI UI: http://127.0.0.1:8000/
• MCP default: streamable-http on http://127.0.0.1:5001 (see config.toml)

Addons

Each addon is a folder under addons/ with:

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

Sample addon: addons/key_value_store/ with kv_get / kv_set.

Shared imports inside 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

Port a tool from dynamic-mcp

# Before
tools/requests_tools.py

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

Move the tool code into tools.py, change utils.* imports to app.mcp.utils, and set 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