MCP 集成

a-calc 内置 MCP 服务器，让 AI 助手能够使用 a-calc 进行精确计算和格式化。

快速开始

1. 安装

npm install a-calc

2. 配置 AI 工具

在配置文件中添加：

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cline / Trae / 其他 MCP 客户端 - 在对应设置中添加

配置：

{
  "mcpServers": {
    "a-calc": {
      "command": "npx",
      "args": ["a-calc-mcp"]
    }
  }
}

💡 说明：

• Claude Desktop 默认工作目录为项目根目录，会自动使用项目本地安装的 a-calc（如果有）
• 如果项目未安装 a-calc，npx 会自动下载最新版本

故障排除：

如果 MCP 服务器无法正常运行，请按以下顺序尝试：

1. 添加 cwd 配置项（某些编辑器如 Trae 需要）：

   {
     "mcpServers": {
       "a-calc": {
         "command": "npx",
         "args": ["a-calc-mcp"],
         "cwd": "${workspaceFolder}"
       }
     }
   }

2. 全局安装：

   npm install -g a-calc

   然后使用：

   {
     "mcpServers": {
       "a-calc": {
         "command": "a-calc-mcp"
       }
     }
   }

3. Windows 特殊说明：如果遇到 Windows requires 'cmd /c' wrapper 错误，将 npx 改为 cmd /c npx

3. 重启 AI 工具

配置完成后重启即可使用。

提供的工具

工具	用途	示例
calc	表达式计算	calc("0.1 + 0.2") → "0.3"
fmt	数字格式化	fmt(1234567, ",") → "1,234,567"
calc_sum	批量求和	calc_sum("price * qty", [...])
basic_calc	基础运算	basic_calc("add", [0.1, 0.2])
chain_calc	链式计算	cadd(100).mul(0.8)()

使用示例

用户：计算 0.1 + 0.2
AI：[调用 calc] → 0.3

用户：把 1234567.89 格式化为千分位，保留2位小数
AI：[调用 fmt] → 1,234,567.89

用户：计算订单总价（商品A: 99.9×2, 商品B: 49.9×3）
AI：[调用 calc_sum] → 349.50

故障排除

问题	解决方案
服务器无法启动	1. 添加 cwd: "${workspaceFolder}" 配置 2. 尝试全局安装 npm install -g a-calc 3. 确保 Node.js 版本 ≥ 18
工具调用失败	检查表达式语法和参数格式
Windows 报错	将 npx 改为 cmd /c npx

相关链接

• MCP 官方文档
• a-calc API 文档