MCP Wolfram Alpha (Client + Server)

What is MCP Wolfram Alpha?

MCP Wolfram Alpha is an MCP (Model Context Protocol) server that interfaces with the Wolfram Alpha API, enabling chat-based applications to perform computational queries and retrieve structured knowledge. It includes an MCP‑Client example utilizing Gemini via LangChain. It is designed for developers who want to integrate Wolfram Alpha’s computational engine into conversational AI systems.

How to use MCP Wolfram Alpha?

Clone the repository, set the required WOLFRAM_API_KEY (and optionally GeminiAPI) in a .env file, and install dependencies with pip install -r requirements.txt or uv sync. For Claude Desktop, add the provided JSON configuration; for VSCode, use the configs/vscode_mcp.json template. Run the client as a CLI tool with python main.py or launch the Gradio UI with python main.py --ui. Docker images are also available for both modes.

Key features of MCP Wolfram Alpha

• Wolfram|Alpha integration for math, science, and data queries.
• Modular architecture easily extendable to additional APIs.
• Multi‑client support handling interactions from multiple interfaces.
• MCP‑Client example using Gemini with LangChain.
• UI support via Gradio for a web interface.

Use cases of MCP Wolfram Alpha

• Add real‑time mathematical and scientific computation to chat bots.
• Build a user‑friendly Gradio web interface for querying Wolfram Alpha.
• Integrate Wolfram Alpha with Claude Desktop or VSCode for on‑demand knowledge retrieval.
• Combine Gemini’s language model with Wolfram Alpha’s structured data in a conversational pipeline.

FAQ from MCP Wolfram Alpha

What API keys are required?

WOLFRAM_API_KEY is required. GeminiAPI is optional and used only if you run the included client.

How do I install dependencies?

Run pip install -r requirements.txt or, if using uv, execute uv sync.

How can I run the Gradio UI?

Run python main.py --ui after setting up the environment and dependencies.

How do I use MCP Wolfram Alpha with Claude Desktop?

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "WolframAlphaServer": {
      "command": "python3",
      "args": ["/path/to/src/core/server.py"]
    }
  }
}

Is Docker support available?

Yes, Dockerfiles are provided in .devops/ for both the UI (ui.Dockerfile) and the CLI client (llm.Dockerfile). Build and run them with the commands shown in the README.