MCP Add Server

MCP 加法服务器

一个最精简的 Model Context Protocol（MCP）服务，提供简单的 add(a, b) 工具。本项目是 MCP 服务实现的基础示例。

功能

• 实现符合 Model Context Protocol 的服务。
• 提供单个工具：add(a, b)，用于返回两个数字之和。
• 可通过 npm 获取，便于安装和使用。

实际运行效果 (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 的服务和客户端之间如何无缝集成和协作。

前置条件

• Node.js（建议使用 18.x.x 或更高版本）
• npm（随 Node.js 一同安装）

安装

快速开始（推荐）

使用此 MCP 服务最简单的方式是通过 npx：

npx @zhefang/mcp-add-server

全局安装

如需频繁使用，可全局安装：

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

然后运行：

mcp-add-server

开发环境设置

1. 克隆代码库：

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

2. 安装依赖：

   npm install
   

3. 在本地运行：

   npm start
   

使用方法

有多种方式可以运行 mcp-add-server：

1. 使用 npx（大多数用户推荐）：

npx @zhefang/mcp-add-server

此命令会下载最新版本的 @zhefang/mcp-add-server 并运行。

2. 全局安装（适合频繁使用）：

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

3. 从克隆的代码库运行：

克隆代码库并安装依赖后：

npm start

4. 在本地链接以进行开发： 在项目根目录中：

npm link
mcp-add-server

服务启动后，MCP 客户端即可通过 stdio 传输与其连接。

客户端示例

src/client.js 文件演示了如何连接到服务：

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);

工具调用示例（JSON）

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

服务响应如下：

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

运行测试

(添加测试后，请在此处说明如何运行测试)

npm test

(目前，npm test 会输出 "Error: no test specified"。添加测试后，请更新 package.json 中的 test 脚本。)

项目结构

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

参与贡献

欢迎贡献！欢迎提交 pull request 或创建 issue。

许可证

本项目采用 MIT License 许可。