MCP Tool Server
A Model Context Protocol style tool server. It advertises a set of tools with JSONschemas so an AI agent can discover them, and executes tool calls safely. This isthe pattern that lets agents act on real systems rather than only chatting.
Why it is useful for companies
Agents are only useful when they can do things: run a calculation, query a service,look something up. MCP standardizes how tools are exposed and called, so the sametools work across different agents and models. This server shows that pattern witha safe registry you extend with your own company tools.
What it does
- Advertises tools with JSON-schema input definitions at
/tools - Executes tool calls at
/call, with input validation and safe evaluation - Ships with three example tools: calculator, stats, knowledge_lookup
Quickstart
make install
make run # http://localhost:8080
curl -s localhost:8080/tools | python3 -m json.tool
curl -s -X POST localhost:8080/call -H "content-type: application/json" \
-d '{"name":"calculator","arguments":{"expression":"2*(3+4)"}}'
Adding your own tool
Decorate a function in app/tools.py with @tool(name, description, schema). It isthen discoverable and callable immediately, no other wiring needed.
Stack
Python, FastAPI, JSON-schema tool registry, Docker, GitHub Actions CI, Pytest.
License
MIT
Workflow diagram
flowchart LR
A[AI agent] -->|GET /tools| S[MCP Tool Server]
S -->|tool schemas| A
A -->|POST /call name+args| S
S --> V[Validate + execute]
V --> R[Result back to agent]
A runnable list-and-call sample is in examples/sample_output.json.
