🧰 mcp-toolbox-server — a Model Context Protocol tool server

A production-shaped MCP server (built on FastMCP) that exposes a suite of safe utility tools to any MCP client — Claude Desktop, IDEs, or your own agent.

🧠 What it does

Model Context Protocol lets LLM clients call external tools over a standard transport. This server registers six tools:

Related MCP server: Aegis MCP Server

🏗️ Architecture

toolbox/
  calculator.py  text.py  units.py  sqltool.py   # pure, unit-tested logic
  server.py                                       # FastMCP wiring (@mcp.tool)
  __main__.py                                     # python -m toolbox  (stdio)

The tool bodies delegate to pure functions, so the entire toolbox is tested without speaking the MCP protocol or needing a client. Safety is enforced in code: the calculator walks a whitelisted AST, and the SQL tool rejects anything but a single read-only SELECT/WITH.

🚀 Run

pip install -r requirements.txt
python -m toolbox          # starts the MCP server on stdio

Register it with an MCP client (e.g. Claude Desktop mcpServers config):

{ "mcpServers": { "toolbox": { "command": "python", "args": ["-m", "toolbox"] } } }

✅ Test

pip install -r requirements-dev.txt && python -m pytest -q

📝 License

MIT — see LICENSE.