🧮 MCP计算器服务器——用TypeScript构建你的第一个MCP工具
轻量级 模型上下文协议(MCP)服务器 内置 TypeScript 使用官方 @modelcontextprotocol/sdk. 此服务器公开了一个执行以下操作的简单工具 两个数字相加,展示如何构建自定义MCP兼容工具。
______________________________________________________________________
🚀 特性
- 使用官方 MCP-SDK
- 使用
add函数 - 写入 TypeScript
- 易于扩展新的MCP工具
______________________________________________________________________
📁 项目结构
my-calculator/
│
├── src/
│ └── index.ts # Main server logic
├── package.json
├── tsconfig.json
└── README.md______________________________________________________________________
⚙️ 安装说明
1.克隆存储库
git clone https://github.com//mcp-calculator-server.git
cd mcp-calculator-server2.安装依赖项
确保你有 Node.js(v18+) 和 npm 安装。
npm install3.建设项目
npm run build4.启动MCP服务器
npm run start您应该看到:
✅ MCP Calculator Server is running...______________________________________________________________________
🧠 运作原理
该项目使用 @modelcontextprotocol/sdk 以创建最小的MCP服务器。
import { server } from "@modelcontextprotocol/sdk/server/stdio";
import { z } from "zod";
const s = server({
name: "MCP Calculator Server",
});
s.tool(
"add",
{
a: z.number(),
b: z.number(),
},
async ({ a, b }) => ({
content: [{ type: "text", text: `Result: ${a + b}` }],
})
);
s.start();
console.log("✅ MCP Calculator Server is running...");这注册了一个 add 工具,需要两个数字(a, b)并返回它们的总和。
______________________________________________________________________
🧩 测试(可选)
如果你想手动测试:
npm run start然后,您可以将此服务器连接到任何 MCP兼容客户端 (比如 克劳德桌面, 带MCP的ChatGPT或其他集成)。
______________________________________________________________________
🧱 构建命令参考
| 命令 | 描述 |
|---|---|
npm run build | 将TypeScript编译为JavaScript |
npm run start | 使用ts节点启动MCP服务器 |
npm install | 安装所有依赖项 |
______________________________________________________________________
🧰 技术栈
- TypeScript
- Node.js
- 模型上下文协议SDK
- Zod(模式验证)
______________________________________________________________________
📜 许可证
MIT许可证——可以自由分叉和修改。
