计算器 MCP 服务器

这是一个使用 TypeScript 实现的，基于模型上下文协议 (MCP) 的综合计算器。

该服务器将各种数学函数作为 MCP 工具公开，允许通过 MCP 客户端（如 Claude for Desktop、Cursor 等）连接的语言模型执行计算。

功能

提供以下功能的 MCP 工具：

• 基本算术： 加法、减法、乘法、除法
• 指数和根： 幂 (^)、平方根
• 三角函数： 正弦、余弦、正切（输入以弧度为单位）
• 反三角函数： 反正弦、反余弦、反正切、Arctan2（输出以弧度为单位）
• 角度/弧度转换： 在角度和弧度之间转换
• 对数： 自然对数 (ln)、以 10 为底的对数 (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
   

运行服务器

1. 构建 TypeScript 代码：

   npm run build
   

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

2. 运行服务器：

   npm run start
   # OR 直接使用 node:
   # node build/index.js
   

服务器将启动并通过标准输入/输出 (stdio) 监听 MCP 连接。您应该在终端的标准错误中看到类似 Calculator MCP Server connected via stdio and ready. 的消息。在使用 Claude Desktop 时，请保持此终端窗口打开。

连接到客户端 (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 工具图标（一个锤子 <img src="https://mintlify.s3.us-west-1.amazonaws.com/mcp/images/claude-desktop-mcp-hammer-icon.svg" style="display: inline; margin: 0; height: 1em;"/> ），并且能够在您要求它执行计算时使用计算器工具。

许可证

MIT 许可证