Omni-mcp

omni-mcp is a universal MCP (Model Context Protocol) server with dynamic tool creation, hot-reload, and multi-executor support. Built on FastMCP.

Stack: Python. Private repo.

Features

Dynamic tool creation — create_tool registers new tools at runtime, no server restart.
Hot-reload — detects and reloads tools when files change.
5 executor types — Python, API, Binary, MCP, Composite.
Tool visibility — first-class MCP tools vs. call_tool-only access (saves context).
Tool labeling — categorize with labels; filter by labels / name patterns / type / visibility.
Security sandboxing — resource limits, execution timeouts, allowlist validation.
Git sync — tool changes auto-sync to the live branch.
XDG — tools stored in ~/.local/share/omni-mcp/tools by default.

Built-in tools

Eight essential tools that cannot be deleted: health_check, list_tools, create_tool, call_tool (with 10-level recursion guard), delete_tool, plus label / search / config helpers.

Configuration

OMNI_MCP_TOOLS_DIR — override tools directory.
OMNI_MCP_REPO_PATH — override repo path for git sync.

uv run omni-mcp                    # defaults
uv run omni-mcp --no-watch         # disable hot-reload (production)
uv run omni-mcp --log-level DEBUG

Sources

README

Features

Built-in tools

Configuration

Sources

See also