README.md•2 kB
# 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
```