mcp-calculator
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-calculatorconvert 25 kilometers to miles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-calculator
An MCP server that wraps MathJS to give AI models a powerful calculate tool.
Supports stdio (Claude Desktop) and HTTP Streamable transports.
Installation
npm install
npm run buildRelated MCP server: aleostudio MCP Server
Usage
Stdio mode (default)
node dist/index.jsHTTP mode
# default port 3000
node dist/index.js --http
# custom port
PORT=8080 node dist/index.js --http
# via environment variable
TRANSPORT=http node dist/index.jsExpression examples
Category | Expression | Result |
Arithmetic |
|
|
Fractions |
|
|
Powers |
|
|
Trigonometry |
|
|
Inverse trig |
|
|
Logarithm |
|
|
Complex numbers |
|
|
Statistics |
|
|
Matrix determinant |
|
|
Matrix multiply |
|
|
Unit conversion |
|
|
Constants |
|
|
Docker
Pull and run the pre-built image from Docker Hub:
# stdio mode (pipe JSON-RPC over stdin/stdout)
docker run --rm -i bangbang93/mcp-calculator node dist/index.js
# HTTP mode on port 3000
docker run --rm -p 3000:3000 bangbang93/mcp-calculator
# custom port
docker run --rm -p 8080:8080 -e PORT=8080 bangbang93/mcp-calculatorBuild locally:
docker build -t mcp-calculator .
docker run --rm -p 3000:3000 mcp-calculatorHTTP mode — usage examples
Once the server is running in HTTP mode (node dist/index.js --http), send JSON-RPC 2.0 requests with curl:
# Initialize a session
curl -X POST http://localhost:3000/ \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
# Call the calculate tool
curl -X POST http://localhost:3000/ \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"calculate","arguments":{"expression":"sin(pi/4)"}}}'Claude Desktop configuration
Add the following to your Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"calculator": {
"command": "node",
"args": ["/absolute/path/to/mcp-calculator/dist/index.js"]
}
}
}Replace /absolute/path/to/mcp-calculator with the actual path where you cloned this repository.
Alternatively, use the Docker image so no local build is required:
{
"mcpServers": {
"calculator": {
"command": "docker",
"args": ["run", "--rm", "-i", "bangbang93/mcp-calculator", "node", "dist/index.js"]
}
}
}GitHub Copilot CLI
Add the server to your GitHub Copilot CLI MCP configuration (~/.config/github-copilot/mcp.json on Linux/macOS, %APPDATA%\GitHub Copilot\mcp.json on Windows):
{
"mcpServers": {
"calculator": {
"command": "node",
"args": ["/absolute/path/to/mcp-calculator/dist/index.js"]
}
}
}Or with Docker:
{
"mcpServers": {
"calculator": {
"command": "docker",
"args": ["run", "--rm", "-i", "bangbang93/mcp-calculator", "node", "dist/index.js"]
}
}
}After saving the config, the calculate tool is available to Copilot in any chat or inline suggestion session. You can also test it directly with gh copilot suggest:
$ gh copilot suggest "calculate sin(pi/4) using the calculator tool"opencode
Add the server to your opencode configuration (~/.config/opencode/config.json):
{
"mcp": {
"calculator": {
"type": "local",
"command": ["node", "/absolute/path/to/mcp-calculator/dist/index.js"]
}
}
}Or HTTP mode (start the server first with node dist/index.js --http):
{
"mcp": {
"calculator": {
"type": "remote",
"url": "http://localhost:3000"
}
}
}Development
# Run TypeScript directly (no build step)
npm run dev
# HTTP mode during development
npm run dev:httpMaintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- Alicense-qualityCmaintenanceA transport-agnostic MCP server that integrates multiple AI coding agents (Claude Code, Gemini, and Codex) with built-in tools for command execution, calculations, and streaming capabilities. Supports both STDIO and HTTP transports for flexible deployment.Last updated571MIT
- FlicenseAqualityDmaintenanceA lightweight MCP server providing utility tools for math, text processing, data conversion, and URL fetching. It supports both STDIO and SSE communication modes for seamless integration with Claude Desktop and remote AI agents.Last updated51
- AlicenseCqualityCmaintenanceA comprehensive MCP server that turns any AI assistant into a powerful mathematical computation engine, providing 52 advanced functions, 158 unit conversions, financial calculations, and secure AST-based evaluation.Last updated1810MIT
- AlicenseAqualityCmaintenanceA Model Context Protocol server that exposes 8 mathematical tools (arithmetic, algebra, calculus, matrix operations, statistics, probability, unit conversions) to any MCP-compatible AI agent, enabling mathematical computations without code.Last updated8281MIT
Related MCP Connectors
This MCP server enables users to perform scientific computations regarding linear algebra and vect…
Educational MCP server with 17 math/stats tools, visualizations, and persistent workspace
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bangbang93/mcp-calculator'
If you have feedback or need assistance with the MCP directory API, please join our Discord server