nativeMCP

nativeMCP

site icon
2025.04.04 5
C++AI Agent开发工具集成开发效率
nativeMCP是一个由C++编写的MCP系统,包含MCP核心架构的host、client和server。host本身相当于一个AI Agent,目前仅支持命令行界面。该系统支持与其他支持MCP的软件(如Cursor)集成,并提供了多种工具和功能。
View on GitHub

Overview

基本能力

产品定位

nativeMCP是一个基于MCP(Model Context Protocol)的系统,旨在通过AI Agent和工具集成提升开发效率。

核心功能

  1. MCPServer:遵循MCP的Server父类,相当于SDK,子类只需继承并新增所需方法即可。目前通信方式仅支持stdio。
  2. servers:继承MCPServer后实现的具体server,可直接使用。
  3. host:宿主应用程序,连接LLM,根据配置加载MCPClient。
  4. MCPClient:在host应用程序内部与服务器保持1:1连接,在LLM需要时调用MCPServer提供的工具。
  5. ModelAdapter:连接LLM的适配层,目前使用cpp-httplib对Ollama发起请求。

适用场景

  1. 开发工具集成:与Cursor等支持MCP的软件集成。
  2. AI辅助开发:通过LLM调用工具完成开发任务。
  3. 本地模型部署:支持Ollama等本地部署的大模型。

工具列表

  1. cpp-time
  2. getCurrentTime:获取当前时间。
  3. waitTime:等待指定的时间。
  4. server-test
  5. getAvailableIP:获取可用的IP列表。
  6. sendToIP:将内容发送到指定的IP地址。
  7. testMultiParams:测试多参数的工具调用。

常见问题解答

  1. 依赖问题:确保安装Qt6.8、cpp-httplib和Ollama。
  2. 编译问题:使用Visual Studio 2022和CMake >= 3.30进行编译。
  3. 配置问题:修改config.json文件以配置MCP Host的功能。

使用教程

使用依赖

  1. Qt6.8bash git clone --branch v6.8.2 git://code.qt.io/qt/qt5.git .\src mkdir build cd build ..\src\configure.bat -init-submodules -submodules qtbase ..\src\configure.bat -debug-and-release -prefix <path-to-qt> cmake --build . --parallel cmake --install . cmake --install . --config debug
  2. vcpkgbash git clone https://github.com/microsoft/vcpkg.git cd vcpkg && bootstrap-vcpkg.bat 将vcpkg.exe的路径添加到系统环境变量PATH中。

安装教程

  1. 克隆源码并进入源码目录: cmd mkdir build cd build cmake .. -G "Visual Studio 17 2022"
  2. 打开build/nativeMCP.sln进行编译和调试。

调试方式

  1. 将host设为启动项,或调试server时将对应的server设为启动项。
  2. 修改config.json文件以配置MCP Host的功能。
  3. 运行示例命令,如获取当前时间并发送给所有可用的IP地址。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。