Nativemcp

🚀 原生MCP系統簡介及實現方案說明

本項目致力於實現一個原生的MCP（Multi-Component Platform）系統，該系統基於組件化架構設計，能有效管理和協調各個服務組件。其核心價值在於提供統一的接口，實現組件間的高效通信和交互，從而滿足多樣化的業務需求。

🚀 快速開始

編譯環境要求

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目錄生成可執行文件

系統啟動

# 運行MCP Host服務
bin/native-host --config config.json

✨ 主要特性

本項目基於組件化架構設計，包含以下核心模塊：

1. Native Host：負責管理各個服務組件，並提供統一的接口進行交互。
2. Client：用於與MCP系統的通信和操作。
3. Server：實現具體的業務邏輯和功能。

📦 安裝指南

技術依賴

• 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目錄生成可執行文件

💻 使用示例

基礎用法

以下是系統運行的示例日誌，展示瞭如何調用不同的MCP工具：

[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"
}

📚 詳細文檔

系統基本組成

1. MCP Server

• 職責：
  • 提供基礎服務支持
  • 實現組件之間的通信機制
  • 定義統一的調用規範

2. Server Components

• 示例實現：
  • cpp-time：提供時間相關服務，包括獲取當前時間、等待指定時長等功能。
  • server-test：用於測試網絡功能，支持獲取可用IP地址和向指定IP發送數據。

配置說明

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"
          }
      ]
  }
  

項目結構

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

🔧 技術細節

本系統主要依賴以下技術：

• Qt Framework (6.8)：提供跨平臺應用開發框架，支持網絡通信、線程管理等基礎功能，確保系統在不同平臺上的兼容性和穩定性。
• cpp-httplib：簡單易用的C++ HTTP服務器庫，用於快速搭建HTTP接口服務，方便系統與外部進行交互。

通過這些技術的結合，系統能夠高效地實現組件化架構，滿足多樣化的業務需求。