原生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