MCP Add Server

A minimal Model Context Protocol (MCP) server that provides a simple add(a, b) tool. This project serves as a basic example of an MCP server implementation.

Features

• Implements a Model Context Protocol compliant server.

• Provides a single tool: add(a, b) which returns the sum of two numbers.

• Available on npm for easy installation and use.

Related MCP server: Basic Math MCP Server

实际运行效果 (Showcase)

下图展示了 mcp-add-server 在 mcp.so 服务发现平台上的配置信息，以及一个兼容 MCP 的聊天机器人 (例如 Cherry Studio) 成功调用本服务器的 add 工具来执行加法运算的场景：

• 左侧: mcp-add-server 在 mcp.so 上的信息，展示了其概述和启动配置。

• 右侧: 一个 MCP 客户端 (例如 Cherry Studio 这样的聊天机器人) 接收到用户关于加法的请求后，调用了 @zhefang/mcp-add-server 提供的 add 工具，并正确返回了计算结果。

这清晰地演示了遵循 Model Context Protocol 的服务器和客户端之间如何无缝集成和协作。

Prerequisites

• Node.js (version 18.x.x or higher recommended)

• npm (comes with Node.js)

Installation

Quick Start (Recommended)

The easiest way to use this MCP server is with npx:

npx @zhefang/mcp-add-server

Global Installation

For frequent use, install globally:

npm install -g @zhefang/mcp-add-server

Then run:

mcp-add-server

Development Setup

1. Clone the repository:

   git clone https://github.com/zhangzhefang-github/mcp-add-server.git
   cd mcp-add-server

2. Install dependencies:

   npm install

3. Run locally:

   npm start

Usage

There are several ways to run the mcp-add-server:

1. Using npx (Recommended for most users):

npx @zhefang/mcp-add-server

This command will download the latest version of @zhefang/mcp-add-server and execute it.

2. Global installation (for frequent use):

npm install -g @zhefang/mcp-add-server
mcp-add-server

3. Running from a cloned repository:

After cloning the repository and installing dependencies:

npm start

4. Local linking for development: In the project's root directory:

npm link
mcp-add-server

Once the server is running, it will be available to MCP clients via stdio transport.

Client Example

The src/client.js file demonstrates how to connect to the server:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["@zhefang/mcp-add-server"]
});

// Connect and use the add tool
await client.connect(transport);
const result = await client.callTool({
  name: "add",
  arguments: { a: 10, b: 5 }
});
console.log("计算结果：", result);

Example Tool Call (JSON)

{
  "tool_name": "add",
  "arguments": {
    "a": 5,
    "b": 3
  }
}

The server responds with:

{
  "content": [
    {
      "type": "text", 
      "text": "结果是：8"
    }
  ]
}

Running Tests

(When tests are added, describe how to run them here)

npm test

(Currently, npm test will output "Error: no test specified". Update the test script in package.json when tests are added.)

Project Structure

mcp-add-server/
├── .git/               # Git directory
├── .gitignore          # Specifies intentionally untracked files that Git should ignore
├── .cursor/            # Cursor specific files (if any)
├── node_modules/       # Project dependencies
├── src/                # Source code
│   └── server.js       # Main server logic
├── bin.js              # Executable for the server
├── LICENSE             # Project license
├── package-lock.json   # Records exact versions of dependencies
├── package.json        # Project metadata and dependencies
└── README.md           # This file

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue.

License

This project is licensed under the MIT License.