README

toolbox-mcp

一个工具型 MCP Server（Tools-only），演示「AI Host → MCP 协议 → 多语言后端」的完整调用链。

三层架构：

层	语言	职责
胶水（协议 + 进程桥）	TypeScript / Node	MCP 协议、工具注册、spawn C++ 子进程
内核（计算）	C++	纯计算内核（如 twoSum 两数之和）

目录结构

toolbox-mcp
├── src/            TS 胶水层
│   ├── server.ts   主入口（serveStdio + 6 个 register）
│   ├── pathGuard.ts 路径守卫（限制读写 data/）
│   └── tools/      6 个工具
├── native/         C++ 内核
│   ├── 001.cpp     twoSum 源码
│   └── 001.exe     编译产物（不提交，见下）
├── data/           读写文件工具的操作目录
└── TODO.md         开发计划（#8 Web 面板待办）

环境要求

Node.js ≥ 20
MinGW g++（编译 C++ 内核用，仅 two_sum 工具需要）

安装

npm i

编译 C++ 内核

native/001.exe 是编译产物，不入库。克隆后需自行编译：

g++ -O2 -std=c++20 -static-libgcc -static-libstdc++ native/001.cpp -o native/001.exe

-static-libgcc -static-libstdc++ 让 exe 自带运行时，避免依赖 libstdc++-6.dll。

运行

npm run dev    # 开发（tsx watch）
npm start      # 运行
npm run typecheck   # 类型检查（tsc --noEmit）

工具列表

工具	说明	层
`echo`	回显消息	TS
`add`	两数相加	TS
`reverse`	反转字符串	TS
`read_file`	读取 `data/` 内文件	TS
`write_file`	写入 `data/` 内文件	TS
`two_sum`	两数之和（spawn C++ 内核）	TS → C++

toolbox-mcp

README

toolbox-mcp

目录结构

环境要求

安装

编译 C++ 内核

运行

工具列表

Recommended Servers