trackmcp
Back to directory
SihaoH

nativemcp

View on GitHub

这是一个由C++编写的MCP系统，包括MCP核心架构的host、client和server

7 stars C++Developer Kits Updated Jun 16, 2025

Documentation

nativeMCP

概述

这是一个由C++编写的MCP系统，包括MCP核心架构的host、client和server；而host本身已经相当于是AI Agent，虽然目前只有命令行（但我觉得也不需要花哨界面）

参考：https://modelcontextprotocol.io/introduction

*server可用于其他支持MCP的软件，如Cursor*

*client也支持MCP官方的servers，和Cursor同样的配置即可*

基本组成

  • MCPServer：遵循MCP的Server父类，相当于SDK，子类只需要继承以及按要求新增所需的方法即可；目前通信方式只支持stdio
  • servers：继承MCPServer后实现的一些具体server，可以直接使用；后续分支再更新更多的工具
  • host：宿主应用程序，连接LLM，根据配置加载MCPClient

    依赖库&外部程序

    • Qt6.8：字符串、Json处理，元对象机制（用于动态调用任意函数）
    • cpp-httplib：用于请求Ollama或是其他在线大模型的api
    • Ollama：本地部署大模型的后端程序

      编译环境

      编译工具链

      • CMake >= 3.30
      • Visual Studio 2022（勾选`使用C++进行桌面开发`）

      vcpkg

      用于导入第三方库cpp-httplib、spdlog

      code
      git clone https://github.com/microsoft/vcpkg.git
cd vcpkg && bootstrap-vcpkg.bat

      然后将vcpkg.exe的路径添加到系统环境变量PATH里

      Qt6.8.2

      可以直接使用在线安装包，不过还是建议自己下载源码来构建。目前只需编译qt-base模块即可。

      参考

      https://doc.qt.io/qt-6/getting-sources-from-git.html

      https://doc.qt.io/qt-6/windows-building.html

      https://doc.qt.io/qt-6/configure-options.html

      下载源码

      `git clone --branch v6.8.2 git://code.qt.io/qt/qt5.git .\src`

      生成

      code
      mkdir build
cd build
..\src\configure.bat -init-submodules -submodules qtbase
..\src\configure.bat -debug-and-release -prefix 
cmake --build . --parallel
cmake --install .
cmake --install . --config debug

      *上述步骤有两次install，第一次默认是只安装release*

      最后将`\bin`添加到系统环境变量PATH中里

      构建

      clone源码并进入到源码目录下

      cmd
      mkdir build
cd build
cmake .. -G "Visual Studio 17 2022"

      最后打开build/nativeMCP.sln进行编译和调试（注意先将host设为启动项，或者要调试server的话则将对应的server设为启动项）

      配置

      修改config.json，可简单配置MCP Host的功能

      • api
        • mcpServers

          示例

          text
          [2025-03-26 12:27:30.296][info][Host.cpp::18] MCP Host初始化
[2025-03-26 12:27:30.299][info][ModelAdapter.cpp::22] ModelAdapter初始化：http://localhost:11434, qwen2.5:7b
[2025-03-26 12:27:30.397][info][Host.cpp::67]
可用工具列表：
cpp-time:
  getCurrentTime 获取当前时间
  waitTime 等待指定的时间
server-test:
  getAvailableIP 获取可用的IP列表
  sendToIP 将内容发送到指定的ip地址
  testMultiParams 测试多参数的工具调用

>>> 获取当前时间，并发送给所有可用的ip
[2025-03-26 12:29:08.349][info][Host.cpp::123] 调用MCP工具[cpp-time::getCurrentTime]: {
    "datetime": "2025-03-26T12:29:08.346",
    "timezone": "Asia/Shanghai"
}

[2025-03-26 12:29:20.160][info][Host.cpp::123] 调用MCP工具[server-test::getAvailableIP]: {
    "ip_list": [
        "192.168.1.201",
        "192.168.1.202",
        "192.168.1.203"
    ]
}

[2025-03-26 12:30:07.784][info][Host.cpp::123] 调用MCP工具[server-test::sendToIP]: {
    "content": "当前时间为：2025-03-26T12:29:08.346 (Asia/Shanghai)",
    "ip": "192.168.1.201",
    "status": "发送成功"
}

[2025-03-26 12:30:07.788][info][Host.cpp::123] 调用MCP工具[server-test::sendToIP]: {
    "content": "当前时间为：2025-03-26T12:29:08.346 (Asia/Shanghai)",
    "ip": "192.168.1.202",
    "status": "发送成功"
}

[2025-03-26 12:30:07.789][info][Host.cpp::123] 调用MCP工具[server-test::sendToIP]: {
    "content": "当前时间为：2025-03-26T12:29:08.346 (Asia/Shanghai)",
    "ip": "192.168.1.203",
    "status": "发送成功"
}

当前时间为：2025-03-26T12:29:08.346 (Asia/Shanghai)

已经将当前时间发送给所有可用的IP地址，发送状态均为成功。

          Frequently asked questions

          What is nativemcp?

          nativemcp is 这是一个由C++编写的MCP系统，包括MCP核心架构的host、client和server

          How do I install nativemcp?

          Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

          Is nativemcp open source?

          Yes — it is hosted on GitHub at https://github.com/SihaoH/nativeMCP and has 7 stars.

          Related MCP tools

          modelcontextprotocoltypescript-sdk

          The official TypeScript SDK for Model Context Protocol servers and clients Trusted by 10500+ developers. Trusted by 10500+ developers.

          10,586 TypeScript
          modelcontextprotocolinspector

          Visual testing tool for MCP servers TypeScript-based implementation. Trusted by 7300+ developers. Trusted by 7300+ developers.

          7,373 TypeScript
          awslabsmcp

          AWS MCP Servers — helping you get the most out of AWS, wherever you use MCP. Python-based implementation. Trusted by 6900+ developers.

          6,922 Python
          awsmcpmcp-client+6
          punkpeyeawesome-mcp-clients

          A collection of MCP clients. Trusted by 5900+ developers. Trusted by 5900+ developers. Trusted by 5900+ developers. Trusted by 5900+ developers.

          5,959
          clientsmcp
          yzflyawesome-mcp-zh

          MCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients Trusted by 4800+ developers. Trusted by 4800+ developers. Trusted by 4800+ developers.

          4,870
          claudeclaude-mcpdeepseek+9
          21st-devmagic-mcp

          It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic TypeScript-based implementation.

          3,887 TypeScript

          Run your own MCP server? See who uses it and what to fix.

          Measure it with TrackMCP