MCP计算器服务

一个基于TypeScript构建的轻量级MCP服务器,提供简单的加法计算功能,展示如何构建自定义MCP兼容工具。

  • by Aditya24023022
  • 本地部署
  • 更新于
在 GitHub 查看 Aditya24023022/MCP-Calculator-Server-using-Model-Context-Protocol-MCP-SDK

使用说明

🧮 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/<your-username>/mcp-calculator-server.git
cd mcp-calculator-server

2.安装依赖项

确保你有 Node.js(v18+) 和 npm 安装。

npm install

3.建设项目

npm run build

4.启动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许可证——可以自由分叉和修改。