toolbox-mcp

A tool-type MCP Server (Tools) demonstrating the complete call chain of "AI Host → MCP Protocol → Multi-language Backend".

Three-layer architecture:

Directory Structure

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 面板待办）

Related MCP server: mini-mcp-demo

Environment Requirements

• Node.js ≥ 20

• MinGW g++ (for compiling the C++ kernel, only needed for the two_sum tool)

Installation

npm i

Compile the C++ Kernel

native/001.exe is a build artifact and is not committed. You need to compile it yourself after cloning:

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

-static-libgcc -static-libstdc++ makes the exe bundle its own runtime, avoiding dependency on libstdc++-6.dll.

Running

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

Tool List