Nativemcp

🚀 原生MCPシステムの概要と実装方案説明

本プロジェクトは、コンポーネント化アーキテクチャに基づいた原生のMCP（Multi-Component Platform）システムを実現することを目的としています。以下の核心モジュールを含んでいます。

1. Native Host：各サービスコンポーネントを管理し、統一されたインターフェースを提供して相互作用を行います。
2. Client：MCPシステムとの通信および操作に使用されます。
3. Server：具体的なビジネスロジックと機能を実装します。

🚀 クイックスタート

システムの基本構成

1. MCP Server

• 役割：
  • 基礎サービスのサポートを提供します。
  • コンポーネント間の通信メカニズムを実装します。
  • 統一された呼び出し規範を定義します。

2. Server Components

• 実装例：
  • cpp-time：時間関連のサービスを提供します。現在の時間の取得、指定された時間の待機などの機能があります。
  • server-test：ネットワーク機能のテストに使用されます。利用可能なIPアドレスの取得や指定されたIPにデータを送信することができます。

技術依存関係

• Qt Framework (6.8)：

  • クロスプラットフォームアプリケーション開発フレームワークを提供します。
  • ネットワーク通信、スレッド管理などの基礎機能をサポートします。

• cpp-httplib：

  • 使いやすいC++のHTTPサーバーライブラリです。
  • HTTPインターフェースサービスを迅速に構築するために使用されます。

コンパイル環境の要件

1. CMake

   # cmakeのバージョンを確認する
   cmake --version
   

2. Visual Studio 2022 Build Tools
3. vcpkg依存管理ツール：

   # qt6-baseとcpp-httplibをインストールする
   vcpkg install qt6-base cpp-httplib
   

ビルド手順

# プロジェクトのルートディレクトリで以下のコマンドを実行する：
mkdir build && cd build
cmake ..
cmake --build .

⚠️ 重要提示

コンパイルが完了すると、./binディレクトリに実行ファイルが生成されます。

設定説明

1. 基本設定

• Config.json

  {
      "log_level": "info",
      "server_list": [
          {
              "name": "cpp-time",
              "binary_path": "bin/cpp-time-server"
          },
          {
              "name": "server-test",
              "binary_path": "bin/server-test"
          }
      ]
  }
  

2. カスタムサーバー設定

• 形式説明：

  {
      "name": "サーバー名",
      "description": "機能説明",
      "methods": [
          {
              "method_name": "メソッド名",
              "parameters": [],
              "return_type": "戻り値の型"
          }
      ]
  }
  

• 例：

  // カスタムサーバー設定を追加する
  {
      "name": "custom-server",
      "binary_path": "bin/custom-server",
      "description": "カスタム機能の実装",
      "methods": [
          {
              "method_name": "custom_method",
              "parameters": ["param1", "param2"],
              "return_type": "JsonObject"
          }
      ]
  }
  

システムの実行例

1. システムの起動

# MCP Hostサービスを実行する
bin/native-host --config config.json

2. 機能デモのログ出力

[2025-03-26T12:29:08.349 INFO] MCPツール[cpp-time::getCurrentTime]を呼び出す:
{
    "datetime": "2025-03-26T12:29:08.346",
    "timezone": "Asia/Shanghai"
}

[2025-03-26T12:29:20.160 INFO] MCPツール[server-test::getAvailableIP]を呼び出す:
{
    "ip_list": [
        "192.168.1.201",
        "192.168.1.202",
        "192.168.1.203"
    ]
}

[2025-03-26T12:30:07.784 INFO] MCPツール[server-test::sendToIP]を呼び出す:
{
    "content": "現在の時間は：2025-03-26T12:30:07.784",
    "receiver": "192.168.1.201"
}

[2025-03-26T12:30:07.786 INFO] MCPツール[server-test::sendToIP]を呼び出す:
{
    "content": "現在の時間は：2025-03-26T12:30:07.784",
    "receiver": "192.168.1.202"
}

プロジェクト構造

.
├── bin/
│   ├── cpp-time-server
│   └── server-test
├── src/
│   ├── CMakeLists.txt
│   └── native-host.cpp
└── config.json