mcp-wolfram-alpha

🚀 MCP 郑和服务器

MCP 郑和服务器是一款基于 Go 语言开发的 MCP 服务器，它能提供对 Wolfram Alpha API 的访问。借助该服务器，MCP 客户端（如 Claude Desktop）可以执行计算任务、获取科学数据以及检索结构化知识。

🚀 快速开始

MCP 郑和服务器将 LLM 的数值计算任务委托给专业的计算引擎 Wolfram Alpha，以此提高计算准确性并减少资源浪费。以下为你介绍使用该服务器的具体步骤。

要求

• 技术要求：需要安装 Go 1.20 或更高版本。
• API 访问：需获取 Wolfram Alpha 的 API ID 并正确配置。

配置

服务器可通过 YAML 文件进行配置，示例如下：

# 示例配置文件
MCP_Servers:
  wolfram-alpha:
    enable: true
    bind: "0.0.0.0:9001"
    config_path: "/path/to/config.yml"

同时，也支持通过环境变量进行配置，如 LOG_PATH 和 WOLFRAM_APP_ID。

构建与运行

构建服务器：

make deps
make build

运行服务器：

./mcp-wolfram-alpha server --config /path/to/config.yml

工具使用

1. 使用 wolfram_query 工具

工具支持以下参数：

{
  "query": "", // 必填字段，Wolfram Alpha 查询内容
  "max_chars": 2000, // 最大返回字符数，默认为 2000
  "units": "metric", // 单位系统，可选值：metric 或 nonmetric
  "country_code": "JP", // 国家代码，如 JP 表示日本
  "language_code": "en", // 语言代码，默认为 en（英语）
  "show_steps": true // 是否显示数学问题的分步解答，默认为 false
}

2. 集成到 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 提出以下问题：

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

Claude Desktop 将自动通过该 MCP 服务器调用 Wolfram Alpha 获取答案。

✨ 主要特性

该 MCP 服务器的目的与优势

目的

该 MCP 服务器将 LLM 的数值计算任务委托给 Wolfram Alpha，从而提高准确性并减少资源浪费。

优势

• 问题背景：LLM 在处理数值计算时存在局限性，例如计算准确性和消耗过多计算资源的问题。
• 解决方案：通过该服务器，LLM 可以将复杂的计算任务外包给专业的计算引擎 Wolfram Alpha，从而提高答案的准确性并减少不必要的计算资源消耗。

功能

• MCP 兼容性：支持 MCP 协议，能够与各种 MCP 客户端兼容。
• Wolfram Alpha 集成：提供对 Wolfram Alpha API 的访问，利用其强大的计算能力。
• 配置选项：支持单位系统、国家代码和语言代码等可配置选项，满足不同用户的需求。

🔧 技术细节

错误处理

服务器提供详细的错误信息，涵盖身份验证错误、无效输入、网络问题、超时和服务器端错误等，并记录日志以方便排查。

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

cnosuke (github.com/cnosuke)