MCP 서버 추가

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 MIT License.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

두 숫자의 합을 계산하기 위한 간단한 add(a, b) 도구를 제공하는 최소 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Calculator Server
githubpradeep
A
security
F
license
A
quality
A simple Model Context Protocol server that provides basic arithmetic operations (addition, subtraction, multiplication, division) as tools that can be called by Large Language Models.
Last updated -
4
MCP Server Basic Example
krishnaik06
-
security
A
license
-
quality
A simple implementation of a Model Context Protocol server that demonstrates core functionality including mathematical tools (add, subtract) and personalized greeting resources.
Last updated -
69
GPL 3.0
MCP Server
mikefey
A
security
F
license
A
quality
A simple Model Context Protocol server that provides standardized tool functionality, currently implementing a basic calculator for adding two numbers together.
Last updated -
2
598
Basic Math MCP Server
bahfahh
A
security
F
license
A
quality
A simple server that provides basic mathematical operations (sum and subtraction) through the Model Context Protocol.
Last updated -
2
1

View all related MCP servers

MCP Add Server

MCP Add Server

Features

实际运行效果 (Showcase)

Prerequisites

Installation

Quick Start (Recommended)

Global Installation

Development Setup

Usage

Client Example

Example Tool Call (JSON)

Running Tests

Project Structure

Contributing

License

Tools

Related Resources

Related MCP Servers

MCP Calculator Server

MCP Server Basic Example

MCP Server

Basic Math MCP Server

New MCP Servers

MCP directory API