MCP Add Server

MCP Add Server

シンプルな add(a, b) ツールを提供する、最小構成の Model Context Protocol（MCP）サーバーです。このプロジェクトは、MCP サーバー実装の基本的な例です。

特長

• Model Context Protocol に準拠したサーバーを実装しています。
• 2つの数値の合計を返す単一のツール add(a, b) を提供します。
• npm から簡単にインストールして使用できます。

実際の動作例

以下の画像は、サービスディスカバリープラットフォーム mcp.so 上の mcp-add-server の設定情報と、MCP 互換のチャットボット（Cherry Studio など）が本サーバーの add ツールを正常に呼び出して加算を実行する様子を示しています。

• 左側：mcp.so 上の mcp-add-server の情報で、概要と起動設定が表示されています。
• 右側：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
   

2. 依存関係をインストールします。

   npm install
   

3. ローカルで実行します。

   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

サーバーの起動後、stdio トランスポート経由で MCP クライアントから利用できるようになります。

クライアントの例

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 を実行すると「Error: no test specified」と出力されます。テストを追加する際は、package.json の test スクリプトを更新してください。)

プロジェクト構成

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 Licenseの下でライセンスされています。