Calculator MCP Server

计算器 MCP 服务

使用 TypeScript 实现的功能全面的计算器，作为模型上下文协议（MCP）服务运行。

该服务将多种数学函数作为 MCP 工具提供，让通过 MCP 客户端（如 Claude for Desktop、Cursor 等）连接的大模型能够执行计算。

功能

提供以下 MCP 工具：

• 基本算术： 加法、减法、乘法、除法
• 幂与根： 乘方（^）、平方根
• 三角函数： 正弦、余弦、正切（输入单位为弧度）
• 反三角函数： 反正弦、反余弦、反正切、双参数反正切（输出单位为弧度）
• 角度/弧度转换： 在角度和弧度之间转换
• 对数： 自然对数（ln）、常用对数（log10）、任意底数的对数
• 常数： Pi（π）、欧拉数（e）
• 阶乘： n!
• 百分比： 计算某个数的百分比
• 取模： 求余运算
• 绝对值： abs()
• 舍入： 向下取整、向上取整、四舍五入到最接近的整数

前置条件

• Node.js（推荐 v16 或更高版本）
• npm（通常随 Node.js 一同安装）

安装

1. 克隆代码仓库：

   git clone https://github.com/mvavassori/calculator-mcp-server.git
   

2. 进入项目目录：

   cd calculator-mcp-server
   

3. 安装依赖：

   npm install
   

构建服务

• 构建 TypeScript 代码：

  npm run build
  

  这会将代码编译到 build 目录中。

连接到客户端（Claude Desktop 示例）

此服务使用 MCP stdio 传输进行通信。要将其连接到 Claude for Desktop：

1. 查找 Claude Desktop 的 MCP 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json（你可以将此路径粘贴到文件资源管理器的地址栏中）。
   • Linux： ~/.config/Claude/claude_desktop_config.json
   • 如果文件或 Claude 目录不存在，你可能需要创建它，或者打开 Claude Desktop 的设置（Claude Menu > Settings... > Developer > Edit Config），这应该会为你创建该文件。

2. 编辑配置文件： 在文本编辑器中打开 claude_desktop_config.json 文件。

3. 添加服务配置： 修改文件，在其中加入 mcpServers 对象，并添加计算器服务条目。如果文件为空或不存在，其完整内容应如下所示：

   {
     "mcpServers": {
       "calculator": {
         "command": "node",
         "args": [
           "/home/marco/code/calculator-mcp-server/build/index.js"
           // IMPORTANT: Replace this path with the ACTUAL ABSOLUTE PATH
           // to the 'build/index.js' file on YOUR system.
         ]
       }
       // You can add other servers here under different keys, like:
       // "another_server": { ... }
     }
   }
   

   注意：

   • 重要： 将 /home/marco/code/calculator-mcp-server/build/index.js 替换为你电脑上克隆的项目目录中 build/index.js 文件的正确绝对路径。
   • 在 Windows 上，路径分隔符请使用双反斜杠（\\），例如："C:\\Users\\YourUser\\path\\to\\calculator-mcp-server\\build\\index.js"。
   • "calculator" 只是你在 Claude 配置中为此服务连接指定的名称，可以使用任何有描述性的名称。
   • 如果 mcpServers 对象已存在，只需在其中添加 "calculator": { ... } 条目；如果其中已有其他服务，请用逗号分隔。

4. 重启 Claude for Desktop： 请确保完全关闭并重新打开 Claude for Desktop，使新配置生效。

现在，Claude for Desktop 应该会显示 MCP 工具图标（锤子 ），并能在你要求它执行计算时使用计算器工具。

许可证

MIT 许可证