What can you do with this server?

This server provides a single tool for performing addition via the Model Context Protocol (MCP). * **Basic arithmetic**: The `add` tool takes two required number arguments (`a` and `b`) and returns their sum. * **MCP compliance**: Works seamlessly with MCP-compatible clients and platforms like chatbots (e.g., Cherry Studio). * **Input validation**: Ensures both inputs are numbers and doesn't accept additional properties. * **Simple API**: Uses a straightforward JSON schema, making integration easy. * **Flexible deployment**: Can be run locally, globally, or via `npx`.

Which integrations are available for this server?

Implements a Model Context Protocol server using [Node.js](/mcp/servers/integrations/node-dot-js) runtime, enabling deployment as a Node.js application. Supports distribution and installation through the [npm](/mcp/servers/integrations/npm) package registry, allowing users to easily install and run the server using npm commands.

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.

npm version

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: MCP Server Basic Example

实际运行效果 (Showcase)

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

MCP Add Server in Action

左侧: 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 @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,

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