# Basic Math MCP Server

A simple Model Context Protocol (MCP) server that provides basic mathematical operations.

## Features

This MCP server provides two tools:
- **sum**: Add two numbers together
- **subtraction**: Subtract the second number from the first number

## Installation

1. Install dependencies:
```bash
npm install
```

2. Build the TypeScript code:
```bash
npm run build
```

## Usage

### Testing the server directly
```bash
npm start
```

### Connecting to AI clients (Claude Desktop, etc.)

1. Copy the `mcp.json` configuration to your AI client's MCP configuration directory
2. Update the path in `mcp.json` to point to your server's location
3. Restart your AI client

### Configuration for Claude Desktop

Add this to your Claude Desktop MCP configuration file:

```json
{
  "mcpServers": {
    "basic-math-server": {
      "command": "node",
      "args": ["/path/to/your/project/build/index.js"],
      "cwd": "/path/to/your/project",
      "description": "A basic math server providing sum and subtraction operations"
    }
  }
}
```

## Available Tools

### sum
- **Description**: Add two numbers together
- **Parameters**:
  - `a` (number): First number
  - `b` (number): Second number
- **Returns**: The sum of the two numbers

### subtraction
- **Description**: Subtract the second number from the first number
- **Parameters**:
  - `a` (number): First number (minuend)
  - `b` (number): Second number (subtrahend)
- **Returns**: The result of a - b

## Development

- **Build**: `npm run build`
- **Start**: `npm start`
- **Development**: `npm run dev` (builds and starts)

## Project Structure

```
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── package.json          # Node.js dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── mcp.json              # MCP server configuration
└── README.md             # This file
```