MCP Add Server

MCP添加服务器

一个最小模型上下文协议（MCP）服务器，它提供了一个简单的 add(a, b) 工具。这个项目是MCP服务器实现的一个基本示例。

](https://badge.fury.io/js/@zhefang%2Fmcp-add-server)

特性

• 实现符合模型上下文协议的服务器。
• 提供单一工具： 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

1. 安装依赖项：

   npm install

1. 在本地运行：

   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 将输出“错误：未指定测试”。更新 test 脚本在 package.json 当添加测试时。)*

项目结构

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

贡献

欢迎投稿！请随时提交拉取请求或打开问题。

许可证

该项目根据 MIT许可证.