Calculator MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Calculator MCP Server
A minimal MCP server exposing four tools —
add, subtract, multiply, divide — in two versions:
calculator_server.py— built with the PythonmcpSDK (FastMCP).@mcp.tool()derives the JSON schema from type hints/docstrings and handles the JSON-RPC protocol for you.calculator_server_raw.py— the same server implemented from scratch with only the standard library (json+sys), nomcpdependency. It hand-rolls the JSON-RPC 2.0 message handling to show what FastMCP is doing underneath: read a newline-delimited JSON request from stdin, dispatch onmethod(initialize,tools/list,tools/call,ping), write a JSON-RPC response to stdout. See the file's top-of-file docstring for the framing details (no LSP-style headers, just one JSON object per line).
Setup
python -m venv .venv
.venv\Scripts\pip install -r requirements.txtRelated MCP server: Math MCP Server
Run it directly (stdio)
MCP servers talk over stdio (or HTTP), not a normal CLI — you don't "run and see output," a client connects to it. Two ways to try it:
1. MCP Inspector (visual, interactive) — requires Node.js/npx:
.venv\Scripts\mcp dev calculator_server.pyOpens a browser UI where you can call add, multiply, etc. by hand.
If the page loads but says "Connect to an MCP server to start inspecting" and there's no Tools tab, the sidebar didn't pick up the command automatically (can happen if a stale/previous session config is cached). Fill in the sidebar manually and click Connect:
Transport Type:
STDIOCommand:
C:\Users\simon\mcpserversample\.venv\Scripts\python.exeArguments:
C:\Users\simon\mcpserversample\calculator_server.py
Once connected, a Tools tab appears in the top nav where you can click "List Tools" and run each one.
2. test_client.py — a scripted client included in this repo that
connects, lists tools, and calls each one. Defaults to calculator_server.py,
or pass a path to test the other version:
.venv\Scripts\python test_client.py
.venv\Scripts\python test_client.py calculator_server_raw.pyWiring it into Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"calculator": {
"command": "C:\\Users\\simon\\mcpserversample\\.venv\\Scripts\\python.exe",
"args": ["C:\\Users\\simon\\mcpserversample\\calculator_server.py"]
}
}
}How it works
calculator_server.pycreates aFastMCPserver and registers each Python function as a tool via the@mcp.tool()decorator. The function's type hints and docstring become the tool's JSON schema and description, which is what the calling client (Claude, the Inspector, ortest_client.py) sees.mcp.run()starts the server listening on stdin/stdout using the MCP stdio transport — the standard way a client launches and talks to a local MCP server as a subprocess.A client connects, calls
list_tools()to discover what's available, thencall_tool(name, args)to invoke one and get the result back.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Unofficial Math.js MCP — wraps the mathjs.org API (free, no auth)
Math MCP server for primality, factorization, Java templates, and integer multiplication.
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA demonstration MCP server that provides calculator functionality through both stdio and FastAPI implementations. Enables users to perform mathematical calculations via MCP tools using the FastMCP framework.-
- FlicenseAqualityDmaintenanceProvides four fundamental arithmetic operations (add, subtract, multiply, divide) as MCP tools with zero-division protection.4-
- FlicenseNot gradedqualityDmaintenanceEnables arithmetic operations such as addition and calculating averages, exposing tools via MCP with stdio and Streamable HTTP transports.-
- FlicenseAqualityCmaintenanceEnables AI agents to perform arithmetic operations — addition, subtraction, multiplication, and division with divide-by-zero validation — through MCP tool calls. It can be run locally over stdio or as an HTTP microservice via streamable-http transport.4-