使用说明

项目简介

Calculate MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供基础的计算器功能。它允许大型语言模型（LLM）通过 MCP 协议调用预设的计算工具，例如加法、减法、乘法、除法、求模和平方根。此服务器旨在作为 MCP 功能的演示和测试示例，同时也可用作简单的玩具项目。

主要功能点

提供计算工具: 内置加法 (add)、减法 (sub)、乘法 (mul)、除法 (div)、求模 (mod) 和平方根 (sqrt) 等计算工具，LLM 可以调用这些工具执行数学运算。
支持多种传输协议: 支持 Stdio 和 SSE (Server-Sent Events) 两种传输协议，可以根据需要选择合适的通信方式。
易于安装和配置: 可以通过 npm 全局安装或在 VS Code 中作为 MCP 服务器添加，配置简单。

安装步骤

方法一：全局安装 (npm)

确保已安装 Node.js 和 npm。

打开终端，运行以下命令全局安装 'calculator-mcp'：

npm install -g @wrtnlabs/calculator-mcp

方法二：在 VS Code 中安装 (推荐)

打开 VS Code 或 VS Code Insiders。
打开命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)。
输入并选择 "MCP: Add MCP Server"。

在弹出的输入框中粘贴以下 JSON 配置信息，然后按 Enter 确认：

{"name":"calculator","command":"npx","args":["-y", "@wrtnlabs/calculator-mcp@latest"]}

对于 VS Code Insiders，请使用以下命令：

{"name":"calculator","command":"npx","args":["-y", "@wrtnlabs/calculator-mcp@latest"]}

服务器配置

对于 MCP 客户端，您需要配置 MCP 服务器的启动信息。以下是推荐的配置，客户端需要根据此配置启动 'calculator-mcp' 服务器并与之通信：

{
  "mcpServers": {
    "calculator": {  // 服务器名称，客户端用此名称引用
      "command": "npx", // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [       // 命令参数
        "-y",         // 自动确认安装 npm 包
        "@wrtnlabs/calculator-mcp@latest" // 要执行的 npm 包，即 calculator-mcp 服务器
      ]
    }
  }
}

参数注释:

'"serverName": "calculator"': 为该 MCP 服务器指定一个名称 "calculator"，客户端将使用此名称来引用和调用此服务器。
'"command": "npx"': 指定用于启动服务器的命令为 'npx'，它允许直接运行 npm 包，无需全局安装。
'"args": [...]"': 'args' 数组包含了传递给 'npx' 命令的参数：
- '"-y"': 这是一个 npm 参数，用于自动确认安装 '@wrtnlabs/calculator-mcp@latest' 包，避免在首次运行时出现交互式提示。
- '"@wrtnlabs/calculator-mcp@latest"': 指定要执行的 npm 包名称和版本，'@latest' 表示使用最新版本。

基本使用方法

启动服务器:
- Stdio 传输 (默认): 如果您的 MCP 客户端默认使用 Stdio 传输，则无需额外配置。当客户端尝试连接名为 "calculator" 的 MCP 服务器时，会根据上述配置自动启动服务器。
- SSE 传输: 如果您希望使用 SSE 传输，需要在启动服务器时指定端口号。在终端中运行以下命令，例如使用端口 8931：
```
npx @wrtnlabs/calculator-mcp@latest --port 8931
```
  然后在 MCP 客户端配置中，将 'url' 属性设置为 'http://localhost:8931/sse'。
客户端调用工具:
- 客户端连接到服务器后，可以通过 MCP 协议发送请求来调用计算器工具。
- 例如，要调用 "add" 工具计算 5 + 3，客户端需要构造符合 MCP 协议的 'CallToolRequest'，指定工具名称为 "add"，参数为 '{"a": 5, "b": 3}'。
- 服务器将执行计算并将结果以 MCP 响应的形式返回给客户端。

注意事项

此服务器仅提供基本的计算功能，适用于简单的数学运算场景。
如果您需要更复杂的计算或功能，可能需要扩展此服务器或使用其他更强大的 MCP 服务器。

关键词