Arithmuse MCP Server

Arithmuse

Arithmuse is a minimal Python MCP server that provides basic calculator tools:

• add
• subtract
• multiply
• divide

Requirements

• Python 3.10+

Install

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Run locally

python -m arithmuse.server

By default, this starts Streamable HTTP transport on 0.0.0.0:$PORT (or port 8000) with MCP endpoint at /mcp.

To run with stdio transport instead:

MCP_TRANSPORT=stdio python -m arithmuse.server

Dedalus deployment notes

• Dedalus entrypoint:
  • python main.py
• This server uses dedalus_mcp and serves /mcp via server.serve().
• Optional env var:
  • DEDALUS_SERVER_NAME (default: calculator-mcp; should match your Dedalus slug)
• Keep the service stateless; no persistent filesystem assumptions are required.
• Ensure your Dedalus runtime installs project dependencies from pyproject.toml.
• Health check expectation: process starts successfully, remains running, and responds on /mcp.
• This repo keeps the arithmuse package at project root so imports work even if the platform does not pip install . first.

Available tools

• add(a, b) -> a + b
• subtract(a, b) -> a - b
• multiply(a, b) -> a * b
• divide(a, b) -> a / b (returns an error for divide-by-zero)

Test

pytest -q