计算器MCP服务器

一个基于TypeScript实现的综合性计算器MCP服务器,提供广泛的数学计算功能,适用于语言模型通过MCP客户端进行数学运算。

  • by mvavassori
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mvavassori/calculator-mcp-server

使用说明

计算器MCP服务器

一个使用TypeScript实现为模型上下文协议(MCP)服务器的综合计算器。

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

特性

提供MCP工具,用于:

  • 基本算术: 加法、减法、乘法、除法
  • 指数和根: 电源(^),平方根
  • 三角函数: 正弦、余弦、切线(以弧度输入)
  • 反三角法: Arcsine、Arccosine、Arc正切、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
    

构建服务器

  • 构建TypeScript代码:
    npm run build
    
    这将代码编译为 build 目录。

连接到客户端(Claude桌面示例)

此服务器使用MCP stdio传输进行通信。要将其连接到Claude for Desktop,请执行以下操作:

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

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %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: 确保Claude for Desktop已完全关闭并重新打开,以便新配置生效。

Claude for Desktop现在应该显示MCP工具图标(锤子 )当你要求它进行计算时,能够使用计算器工具。

许可证

MIT许可证