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:

npm install

2. Build the TypeScript code:

npm run build

Usage

Testing the server directly

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:

{
  "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