Skip to main content
Glama
deenesjakoruzh

MCP Add Server

by zhangzhefang-github
npmGitHub
JavaScript
MIT License
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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

  1. Clone the repository:
    git clone https://github.com/zhangzhefang-github/mcp-add-server.git cd mcp-add-server
  2. Install dependencies:
    npm install
  3. 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
A
security – no known vulnerabilities
A
license - permissive license
A
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

Ein minimaler Model Context Protocol-Server, der ein einfaches Add(a, b)-Tool zum Berechnen der Summe zweier Zahlen bereitstellt.

  1. Merkmale
    1. Voraussetzungen
      1. Installation
        1. Verwendung
          1. Beispiel für einen Tool-Aufruf (konzeptionell)
        2. Ausführen von Tests
          1. Projektstruktur
            1. Beitragen
              1. Lizenz

                Related Resources

                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

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhangzhefang-github/mcp-add-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server