MCP Wolfram Alpha

🚀 MCP Zhenghe Server

The MCP Zhenghe Server is an MCP server developed in Go language, providing access to the Wolfram Alpha API. It enables MCP clients (e.g., Claude Desktop) to perform computational tasks, obtain scientific data, and retrieve structured knowledge.

🚀 Quick Start

Purpose and Advantages of the MCP Server

Purpose

This MCP server delegates numerical computation tasks of LLMs to Wolfram Alpha, thereby improving accuracy and reducing resource waste.

Advantages

• Problem Background: LLMs have limitations in handling numerical computations, such as issues with computational accuracy and excessive consumption of computational resources.
• Solution: Through this server, LLMs can outsource complex computational tasks to the professional computational engine Wolfram Alpha, thus enhancing the accuracy of answers and reducing unnecessary consumption of computational resources.

Features

• MCP Compatibility: Supports the MCP protocol and is compatible with various MCP clients.
• Wolfram Alpha Integration: Provides access to the Wolfram Alpha API, leveraging its powerful computational capabilities.
• Configuration Options: Supports configurable options such as unit systems, country codes, and language codes to meet the needs of different users.

Requirements

• Technical Requirement: Requires the installation of Go 1.20 or a higher version.
• API Access: You need to obtain the API ID of Wolfram Alpha and configure it correctly.

Configuration

The server is configured through a YAML file. Here is an example:

# Example configuration file
MCP_Servers:
  wolfram-alpha:
    enable: true
    bind: "0.0.0.0:9001"
    config_path: "/path/to/config.yml"

It also supports configuration via environment variables, such as LOG_PATH and WOLFRAM_APP_ID.

Building and Running

Build the server:

make deps
make build

Run the server:

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

Tool Usage

1. Using the wolfram_query Tool

The tool supports the following parameters:

{
  "query": "", // Required field, content of the Wolfram Alpha query
  "max_chars": 2000, // Maximum number of returned characters, default is 2000
  "units": "metric", // Unit system, optional values: metric or nonmetric
  "country_code": "JP", // Country code, e.g., JP represents Japan
  "language_code": "en", // Language code, default is en (English)
  "show_steps": true // Whether to show step - by - step solutions for math problems, default is false
}

2. Integrating into Claude Desktop

Edit the claude_desktop_config.json file:

{
  "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"
      }
    }
  }
}

Usage Examples

After configuration, users can ask the following questions through Claude Desktop:

• "What is the derivative of x^3?"
• "Calculate the distance from the Earth to Mars."
• "What is the atomic weight of gold?"
• "Convert 100 kilometers to miles."
• "Solve the equation x^2 + 3x - 4 = 0."

Claude Desktop will automatically call Wolfram Alpha through this MCP server to obtain answers.

Error Handling

The server provides detailed error information, covering authentication errors, invalid inputs, network issues, timeouts, and server - side errors, and logs are recorded for easy troubleshooting.

License

This project is licensed under the MIT License.

Author

cnosuke (github.com/cnosuke)