Addition MCP Server

# My MCP Server A simple Model Context Protocol (MCP) server that provides an addition tool for adding two numbers together. ## Overview This MCP server implements a basic arithmetic tool that can add two numbers. It's built using the official MCP SDK and demonstrates how to create a custom MCP server. ## Features - **Addition Tool**: Adds two numbers together - **MCP Protocol**: Follows the Model Context Protocol specification - **Type Safety**: Uses Zod for input validation ## Installation 1. Clone or download this repository 2. Install dependencies: ```bash npm install ``` ## Usage ### Running the Server To run the MCP server: ```bash node mcp.js ``` The server will start and listen for MCP protocol messages via stdio. ### Available Tools #### Addition Tool - **Name**: `add` - **Description**: Add two numbers together - **Parameters**: - `a` (number): First number - `b` (number): Second number - **Returns**: The sum of the two numbers as text ### Example Usage When connected to an MCP client, you can use the addition tool like this: ```json { "tool": "add", "parameters": { "a": 5, "b": 3 } } ``` This would return: `8` ## Adding to Cursor To use this MCP server in Cursor, you need to configure it in your Cursor settings: ### Method 1: Using Cursor Settings UI 1. **Open Cursor Settings**: - Press `Cmd+,` (Mac) or `Ctrl+,` (Windows/Linux) - Or go to `Cursor > Preferences > Settings` 2. **Navigate to MCP Settings**: - Search for "MCP" in the settings search bar - Click on "Model Context Protocol" settings 3. **Add the Server**: - Click "Add Server" or the "+" button - Configure the server with these settings: ``` Name: Addition Server Command: node Args: [path/to/your/mcp.js] Cwd: [path/to/your/project/directory] ``` ### Method 2: Using Settings JSON 1. **Open Cursor Settings JSON**: - Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux) - Type "Preferences: Open Settings (JSON)" - Select it 2. **Add MCP Configuration**: Add this configuration to your settings JSON: ```json { "mcp.servers": { "addition-server": { "command": "node", "args": ["/Users/slav/Documents/dev/first-mcp/mcp.js"], "cwd": "/Users/slav/Documents/dev/first-mcp" } } } ``` **Important**: Replace the paths with your actual project directory path. 3. **Restart Cursor**: - Close and reopen Cursor for the changes to take effect ### Using the Addition Tool in Cursor Once configured, you can use the addition tool in Cursor by: 1. **Opening a chat** with the AI assistant 2. **Asking it to add numbers**: "Can you add 15 and 27 for me?" 3. **The AI will use your MCP server** to perform the calculation ### Troubleshooting - **Server not found**: Make sure the path to `mcp.js` is correct and the file exists - **Permission errors**: Ensure you have execute permissions on the Node.js binary - **Dependencies missing**: Run `npm install` in the project directory first - **Port conflicts**: This server uses stdio, so no port conflicts should occur ## Development ### Project Structure - `mcp.js` - Main server implementation - `package.json` - Node.js project configuration - `README.md` - This file ### Dependencies - `@modelcontextprotocol/sdk` - Official MCP SDK - `zod` - Type validation library ## License ISC