Sample Cpp MCP Servers

🚀 mcp-sample-cpp-servers

このプロジェクトは、C++で実装されたMCP Serversのサンプルです。以下の記事のC++実装を完全にコピーしています。 MCP Servers入門

標準入出力の機能のみ検証されています。また、このプロジェクトはプロトコルの使用をデモンストレーションすることを目的としているため、関数呼び出しのサポートのみを実装しています。ブログ上にコード公開ページを作成した後（nヶ月後）、このリポジトリは削除予定です。

🚀 クイックスタート

🔧 セットアップ

1. C++コンパイラ（gccやMSVCなど）と必要な開発ライブラリがインストールされていることを確認してください。
2. プロジェクトをIDEに追加してビルドします。
3. コンパイルによって生成された実行ファイルをターミナルで実行すると、MCPサーバーが起動します。

💻 使用例

基本的な使用法

# ツールリストのリクエストを送信
curl -X POST http://localhost:5000/tools/list

# evaluate-scoresツールを呼び出す
curl -X POST http://localhost:5000/tools/call \
     -H "Content-Type: application/json" \
     -d '{"tool":"evaluate-scores","params":{"scores":[1,2,3,4,5]}}'

出力

• ツールリストのリクエストは、登録されたツールの情報を返します。
• スコア評価の呼び出しは、合計点と平均点を返します。

✨ 主な機能

• MCPサーバーを初期化し、プロトコルバージョンとサーバー情報を設定します。
• evaluate-scoresという名前のツールを登録し、一連のスコアを評価します。
• evaluate-scoresツールの呼び出し処理ロジックを実装し、合計点と平均点を計算します。

📦 インストール

1. C++コンパイラ（gccやMSVCなど）をインストールします。
2. 必要な開発ライブラリをインストールします。
3. プロジェクトをクローンし、IDEに追加してビルドします。

💻 使用例

基本的な使用法

#include <iostream>
#include <fstream>
#include <chrono>
#include <unordered_map>
#include "mcp-server.hpp"

#if defined(_MSC_VER)
#include <fcntl.h>
#include <io.h>
#endif

/// <summary>
/// 時間を表すフォーマット済みの文字列を取得します。
/// </summary>
/// <returns>時間を表すフォーマット済みの文字列</returns>
auto getTimeString() {
    const std::chrono::time_zone* tz = std::chrono::current_zone();
    return std::format("[{:%Y-%m-%d %H:%M:%S}]", tz->to_local(std::chrono::system_clock::now()));
}

int main() {
#if defined(_MSC_VER)
    // WindowsのテキストモードでのCRLF↔LF自動変換問題を解決するため、標準入出力をバイナリモードに設定します。
    _setmode(_fileno(stdin), _O_BINARY);
    _setmode(_fileno(stdout), _O_BINARY);
#endif

    mcp::MCPServer server;

    // MCPサーバーの初期化
    server.request.onInitialize = [&](const mcp::InitializeRequest& params) {
        std::cerr << getTimeString() << "initialize" << std::endl;

        return mcp::InitializeResult{
            .protocolVersion = params.protocolVersion,
            .capabilities = {
                .tools = mcp::ServerCapabilities::ToolsInner{}
            },
            .serverInfo = {
                .name = "ABC游戏",
                .version = "1.0.0"
            }
        };
    };

    // MCPサーバーの初期化完了
    server.notification.onInitialized = [&]() {
        std::cerr << getTimeString() << "notifications/initialized" << std::endl;
    };

    // ツールの登録
    server.request.tools.onList = [&]() {
        std::cerr << getTimeString() << "tools/list" << std::endl;

        return mcp::ListToolsResult{
            .tools = {
                {
                    .name = "evaluate-scores",
                    .description = "ABC游戏的分数评估",
                    // Zodの以下のJSONスキーマ定義に相当します
                    // z.object({ score: z.number().min(0).describe("得分（点）") })
                    .inputSchema = nlohmann::json::object({
                        {"type", "object"},
                        {"properties", {
                            {"score", {
                                {"type", "number"},
                                {"minimum", 0},
                                {"description", "得分（点）"}
                            }}
                        }},
                        {"required", ["score"]}
                    })
                }
            }
        };
    };

    // ツール呼び出しの処理
    server.request.tools.onCall = [&](const std::string& toolName, const nlohmann::json& input) {
        std::cerr << getTimeString() << "tools/call " << toolName << " " << input.dump(4) << std::endl;

        if (toolName == "evaluate-scores") {
            if (!input["scores"].is_array()) {
                throw nlohmann::json::invalid_argument("Expected 'scores' to be an array");
            }

            size_t scoreCount = input["scores"].size();
            double total = 0.0;
            for (const auto& score : input["scores"]) {
                if (!score.is_number()) {
                    throw nlohmann::json::invalid_argument("Each score must be a number");
                }
                total += score.get<double>();
            }

            return nlohmann::json{
                {"total", static_cast<int64_t>(total)},
                {"average", total / scoreCount}
            };
        }

        throw nlohmann::json::invalid_argument("Unknown tool: " + toolName);
    };

    // MCPサーバーの起動
    std::cerr << getTimeString() << "启动 MCP Server" << std::endl;
    server.start();

    while (true) {
        std::this_thread::sleep_for(std::chrono::seconds(1));
    }

    return 0;
}

説明

• コード構造：これはMCPサーバーの完全な実装で、初期化、ツールの登録、およびツール呼び出しの処理方法を示しています。
• 主な機能：
  • MCPサーバーを初期化し、プロトコルバージョンとサーバー情報を設定します。
  • evaluate-scoresという名前のツールを登録し、一連のスコアを評価します。
  • evaluate-scoresツールの呼び出し処理ロジックを実装し、合計点と平均点を計算します。
• プラットフォーム固有のコード：Windows環境でのファイル操作の問題を解決するため、バイナリモードの設定を行っています。