calculator-mcp

Calculator MCP 服务

一个简单的 Model Context Protocol（MCP）服务，通过 MCP 工具提供基本的计算器功能。

功能

此 MCP 服务提供以下计算器工具：

• add：将两个数相加
• subtract：用第一个数减去第二个数
• multiply：将两个数相乘
• divide：用第一个数除以第二个数（可防止除以零）
• power：计算第一个数的第二个数次幂
• sqrt：计算一个数的平方根（可防止对负数开平方）

安装

1. 安装依赖项：

npm install

2. 构建 TypeScript 代码：

npm run build

用法

运行服务

启动 MCP 服务：

npm start

或者以开发模式运行：

npm run dev

MCP 客户端配置

要将此计算器 MCP 服务与 MCP 客户端（例如 Claude Desktop）配合使用，请将其添加到 MCP 配置中：

{
  "mcpServers": {
    "calculator": {
      "command": "node",
      "args": ["/path/to/calculator-mcp/dist/index.js"],
      "env": {}
    }
  }
}

可用工具

add

将两个数相加。

• 参数：a（数字）、b（数字）
• 示例：add(5, 3) 返回 5 + 3 = 8

subtract

用第一个数减去第二个数。

• 参数：a（数字）、b（数字）
• 示例：subtract(10, 4) 返回 10 - 4 = 6

multiply

将两个数相乘。

• 参数：a（数字）、b（数字）
• 示例：multiply(6, 7) 返回 6 × 7 = 42

divide

用第一个数除以第二个数。

• 参数：a（数字）、b（数字）
• 示例：divide(15, 3) 返回 15 ÷ 3 = 5
• 错误处理：除数为零时返回错误

power

计算底数的指数次幂。

• 参数：base（数字）、exponent（数字）
• 示例：power(2, 8) 返回 2^8 = 256

sqrt

计算一个数的平方根。

• 参数：number（数字）
• 示例：sqrt(16) 返回 √16 = 4
• 错误处理：输入负数时返回错误

开发

项目结构

calculator-mcp/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

构建

npm run build

开发模式

npm run dev

错误处理

计算器针对以下情况提供了适当的错误处理：

• 除以零
• 对负数开平方
• 无效的工具名称
• 一般执行错误

所有错误都会附带相应的错误消息返回，并将 isError 标志设为 true。

许可证

MIT