MCP Wolfram Alpha 服务器

MCP Wolfram Alpha 服务器是一个基于 Go 的 MCP 服务器，它提供对 Wolfram Alpha API 的访问。它允许 MCP 客户端（例如，Claude Desktop）执行计算查询、访问科学数据和检索结构化知识。

此 MCP 服务器的目的和优势

目的

此 MCP 服务器将大型语言模型 (LLM) 难以处理的数值计算任务委托给高精度计算引擎 Wolfram Alpha。

理解 LLM 的局限性

LLM 在自然语言处理、文本生成和翻译方面表现出卓越的能力，但它们的架构并未针对精确的数值计算或公式处理进行优化。

• 计算准确性： 除了基本的算术运算（例如，2+3）之外，LLM 可能会出现计算错误，尤其是在处理多位数或复杂公式（微积分、矩阵计算等）时。
• Token 消耗： 当 LLM 尝试在内部进行复杂计算时，它们需要许多步骤和推断，这可能会低效地消耗宝贵的 token（计算资源）。在某些情况下，它们可能会在得出正确答案之前达到 token 限制。

此 MCP 服务器的作用和优势

此 MCP 服务器解决了以下挑战：

• 高精度计算： 当 LLM 收到需要计算的任务时，它会将计算部分作为请求发送到此 MCP 服务器。服务器将请求转发到 Wolfram Alpha API，并将准确的计算结果返回给 LLM，从而为用户提供可靠的计算输出。
• 减少 LLM 工作负载： LLM 不再需要自己执行计算，从而使它们能够专注于其在语言处理和上下文理解方面的优势。
• 优化 Token 使用： 该服务器可防止 LLM 尝试在内部进行不确定计算时发生的低效 token 消耗。 通过将计算任务委托给外部 API（通过此 MCP 服务器的 Wolfram Alpha），token 使用仅限于 API 请求和响应交换，从而实现更高效的整体处理。

推荐用例

建议 LLM 在需要执行以下计算时积极使用此 MCP 服务器：

• 算术运算（尤其是超出简单心算范围的运算，例如包含许多位数或小数的运算）
• 解代数方程
• 微分和积分
• 线性代数（矩阵计算等）
• 统计计算
• 涉及物理或化学中特定公式的计算
• 单位和货币转换（尤其是在需要当前汇率时）

但是，对于像 1+1 这样明显在 LLM 能力范围内的极其简单的计算，则无需查询外部 API。 对于 LLM 可以可靠处理的计算，它们应该直接进行。

总之，此 MCP 服务器是一个重要的支持工具，可帮助 LLM 克服计算准确性和 token 效率方面的挑战，从而实现更可靠和高效的响应。当需要计算时（除了非常简单的计算），请积极使用此 MCP 服务器 API，以避免不必要的 token 消耗。

功能

• MCP 兼容性：根据 MCP 规范实现基于 JSON-RPC 的接口
• Wolfram Alpha 集成：提供对数学计算、科学数据和知识查询的访问
• 可配置选项：支持单位系统、区域设置和语言选项

要求

• Go 1.24 或更高版本
• Wolfram Alpha API ID（可从 Wolfram Alpha Developer Portal 获取）

配置

服务器通过 YAML 文件进行配置（默认：config.yml）：

log: 'path/to/mcp-wolfram-alpha.log' # 日志文件路径（空表示不记录日志）
debug: false # 启用调试模式

wolfram:
  app_id: 'YOUR_WOLFRAM_ALPHA_APP_ID' # 必需：Wolfram Alpha API ID
  timeout: 30 # API 超时时间（秒）
  use_bearer: false # 使用 Bearer token 身份验证
  default_max_chars: 2000 # 响应中的默认最大字符数

您可以使用环境变量覆盖配置：

• LOG_PATH: 日志文件路径
• DEBUG: 启用调试模式（true/false）
• WOLFRAM_APP_ID: Wolfram Alpha API ID
• WOLFRAM_TIMEOUT: 超时时间（秒）
• WOLFRAM_USE_BEARER: 使用 Bearer 身份验证（true/false）
• WOLFRAM_DEFAULT_MAX_CHARS: 默认最大字符数

构建和运行

# 下载依赖项
make deps

# 构建服务器
make build

# 运行服务器
./bin/mcp-wolfram-alpha server --config config.yml

MCP 工具

实现了以下 MCP 工具：

• wolfram_query: 执行 Wolfram Alpha 查询，并提供自定义选项

工具参数

wolfram_query 工具接受以下参数：

{
  "query": "integrate x^2",
  "max_chars": 2000,
  "units": "metric",
  "country_code": "JP",
  "language_code": "en",
  "show_steps": true
}

• query (必需): 要执行的 Wolfram Alpha 查询
• max_chars: 响应中的最大字符数（默认：2000）
• units: 要使用的单位系统（metric 或 nonmetric）
• country_code: 用于本地化的国家/地区代码（例如，'JP'）
• language_code: 用于本地化的语言代码（例如，'ja'）
• show_steps: 请求数学问题的逐步解决方案（布尔值）

与 Claude Desktop 一起使用

要与 Claude Desktop 集成，请编辑您的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "wolfram-alpha": {
      "command": "/path/to/bin/mcp-wolfram-alpha",
      "args": ["server", "--config", "/path/to/config.yml"],
      "env": {
        "LOG_PATH": "/path/to/logs/mcp-wolfram.log",
        "WOLFRAM_APP_ID": "YOUR_WOLFRAM_ALPHA_APP_ID"
      }
    }
  }
}

使用示例

正确配置 Claude Desktop 后，您可以向 Claude 提出如下问题：

• "x^3 的导数是什么？"
• "计算地球到火星的距离"
• "金的原子量是多少？"
• "将 100 公里转换为英里"
• "解方程 x^2 + 3x - 4 = 0"

Claude 将自动通过此 MCP 服务器使用 Wolfram Alpha API 来计算答案。

错误处理

服务器为各种故障场景提供信息丰富的错误消息：

• 身份验证错误（无效的 API ID）
• 无效的输入错误
• 网络连接问题
• 超时错误
• 服务器端 Wolfram Alpha 错误

所有错误都会记录详细信息，以帮助进行故障排除。

许可证

本项目根据 MIT 许可证获得许可。

作者

cnosuke (github.com/cnosuke)