# 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:

1. **Calculator API** (`calculator-api.js`): Handles basic mathematical operations
2. **MCP Server** (`mcp-server.js`): Manages LLM integration and tool orchestration
3. **MCP Client** (`mcp-client.js`): Provides a user interface for interacting with the service

## Setup

1. Install dependencies:

```bash
npm install
```

2. Create a `.env` file in the root directory with the following variables:

```
ANTHROPIC_API_KEY=your_api_key_here
PORT=3000
MCP_PORT=3001
```

## Running the Service

You can run all components concurrently:

```bash
npm start
```

Or run them individually:

```bash
# Calculator API
npm run start:calculator

# MCP Server
npm run start:mcp

# MCP Client
npm run start:client
```

## 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 tools
- `POST /execute/:toolId` - Execute a specific tool
- `POST /agent` - Process natural language requests
- `GET /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)