zhangzhefang-github/mcp-add-server
If you are the rightful owner of mcp-add-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A minimal Model Context Protocol (MCP) server that provides a simple `add(a, b)` tool.
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.
实际运行效果 (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
- Clone the repository:
git clone https://github.com/zhangzhefang-github/mcp-add-server.git cd mcp-add-server - Install dependencies:
npm install - 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 .
