Manages environment variables for the MCP server, including Anthropic API keys and port configurations.
Used for making HTTP requests to the calculator API endpoints, enabling the MCP server to perform mathematical operations like addition, subtraction, multiplication, division, and power calculations.
Powers the API endpoints for both the calculator service and MCP server, handling requests for mathematical operations and tool execution.
MCP Calculator Service
A Model-Context-Protocol (MCP) implementation for a calculator service that uses Claude AI to process natural language requests and perform mathematical calculations.
Architecture
The service consists of three main components:
- Calculator API (
calculator-api.js
): Handles basic mathematical operations - MCP Server (
mcp-server.js
): Manages LLM integration and tool orchestration - MCP Client (
mcp-client.js
): Provides a user interface for interacting with the service
Setup
- Install dependencies:
- Create a
.env
file in the root directory with the following variables:
Running the Service
You can run all components concurrently:
Or run them individually:
Usage
Once the service is running, you can interact with it through the client interface. Here are some example commands:
- "Add 5 and 3"
- "What is 10 plus 20?"
- "Calculate 7.5 + 2.25"
- "Multiply 4 by 6"
- "What is 8 times 3?"
Type "help" for more examples or "exit" to quit.
API Endpoints
Calculator API (Port 3000)
POST /:operation
- Perform mathematical operations (add, subtract, multiply, divide, power)GET /health
- Health check endpoint
MCP Server (Port 3001)
GET /tools
- List available toolsPOST /execute/:toolId
- Execute a specific toolPOST /agent
- Process natural language requestsGET /health
- Health check endpoint
Error Handling
The service includes comprehensive error handling for:
- Invalid mathematical operations
- Division by zero
- Invalid parameter types
- LLM response parsing errors
- Network errors
Dependencies
- @anthropic-ai/sdk: ^0.51.0
- axios: ^1.6.7
- body-parser: ^1.20.2
- cors: ^2.8.5
- dotenv: ^16.4.5
- express: ^4.18.3
- concurrently: ^8.2.2 (dev dependency)
This server cannot be installed
A service that processes natural language requests to perform mathematical calculations by integrating Claude AI with a calculator API through the Model-Context-Protocol architecture.
Related MCP Servers
- -securityFlicense-qualityA Node.js server that processes mathematical calculations and natural language math queries through RESTful API endpoints.Last updated -JavaScript
- AsecurityFlicenseAqualityA simple server that provides basic arithmetic operations (addition, subtraction, multiplication, division) as tools that can be called by Large Language Models through the Model Context Protocol.Last updated -4JavaScript
- -securityAlicense-qualityA mathematical expression calculator that processes user-input expressions and returns computed results, supporting basic operations and built-in constants like PI and E.Last updated -4082TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.Last updated -1753TypeScriptMIT License