Example Calculator MCP

计算器MCP服务器示例

一个简单的模型上下文协议（MCP）服务器，提供基本的计算器工具。此服务器演示了如何创建MCP工具，可以用作模板或测试MCP部署系统。

特性

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

• 添加 -将两个数字相加
• 减去 -从第一个数字中减去第二个数字
• 乘 -将两个数字相乘
• 分割 -将第一个数字除以第二个数字（具有零分保护）
• 力量 -将第一个数字提升到第二个数字的幂
• 平方根 -计算一个数字的平方根（带负数保护）

安装

1. 克隆此存储库
2. 安装依赖项：

   npm install

用法

运行服务器

HTTP服务器（建议部署）：

npm start
# or explicitly
npm run start:http

Stdio服务器（用于克劳德桌面和本地使用）：

npm run start:stdio

开发模式：

npm run dev          # HTTP server with auto-reload
npm run dev:stdio    # Stdio server with auto-reload

默认情况下，HTTP服务器在端口8000上运行，包括：

• SSE 端点 在 /sse 用于MCP通信
• 健康检查在 /health
• 服务器信息位于 /

stdio版本用于与Claude Desktop和其他本地MCP客户端直接集成。

工具调用示例

当连接到MCP客户端时，您可以使用以下工具：

补充：

{
  "tool": "add",
  "arguments": {
    "a": 5,
    "b": 3
  }
}

结果：“5+3=8”

部门：

{
  "tool": "divide", 
  "arguments": {
    "a": 10,
    "b": 2
  }
}

结果：“10÷2=5”

功率：

{
  "tool": "power",
  "arguments": {
    "base": 2,
    "exponent": 3
  }
}

结果：“2^3=8”

配置

配备克劳德桌面（Stdio）

添加到您的Claude Desktop配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%/Claude/claude_desktop_config.json

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

使用HTTP/SSE传输

对于基于web的客户端或部署系统，请使用HTTP服务器：

npm run start:http

然后连接到： http://localhost:8000/sse

与kagent.dev

此服务器旨在与kagent.dev部署配合使用。用途：

python deploy_mcp.py github.com/your-org/example-calculator-mcp

部署脚本将自动执行以下操作：

• 检测Node.js项目
• 使用 npm start （HTTP服务器）
• 进行适当的健康检查
• 创建kagent ToolServer资源

项目结构

example-calculator-mcp/
├── src/
│   └── index.js          # Main MCP server implementation
├── package.json          # Project configuration and dependencies
└── README.md            # This file

错误处理

服务器包括以下正确的错误处理：

• 除以零
• 负数的平方根
• 工具名称无效
• 缺少或无效的参数

依赖项

• @modelcontextprotocol/sdk -用于JavaScript/Node.js的官方MCP SDK

许可证

MIT许可证-您可以自由地将其用作您自己的MCP服务器的模板。

使用kagent.dev进行测试

此服务器旨在与kagent.dev等部署系统配合使用。简单的结构和标准的npm脚本使其易于容器化和自动部署。