🚀 原生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接口服务，方便系统与外部进行交互。

通过这些技术的结合，系统能够高效地实现组件化架构，满足多样化的业务需求。