Skip to content
Back to search

mcp-wolframalpha

A Python-powered Model Context Protocol MCP server and client that uses Wolfram Alpha via API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/akalaric--mcp-wolframalpha/badge.svg)](/listings/akalaric--mcp-wolframalpha)

HTML

<a href="/listings/akalaric--mcp-wolframalpha"><img src="/api/listings/akalaric--mcp-wolframalpha/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Clone the Repo

   git clone https://github.com/ricocf/mcp-wolframalpha.git

   cd mcp-wolframalpha

Set Up Environment Variables

Create a .env file based on the example:

- WOLFRAM_API_KEY=your_wolframalpha_appid

- GeminiAPI=your_google_gemini_api_key *(Optional if using Client method below.)*

Install Requirements

   pip install -r requirements.txt

Install the required dependencies with uv: Ensure [`uv`](https://github.com/astral-sh/uv) is installed.

   uv sync

Configuration

To use with the VSCode MCP Server: 1. Create a configuration file at `.vscode/mcp.json` in your project root. 2. Use the example provided in `configs/vscode_mcp.json` as a template. 3. For more details, refer to the [VSCode MCP Server Guide](https://sebastian-petrus.medium.com/vscode-mcp-server-42286eed3ee7).

To use with Claude Desktop:

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Wolfram Alpha (Server + Client)
  2. Seamlessly integrate Wolfram Alpha into your chat applications.
  3. This project implements an MCP (Model Context Protocol) server designed to interface with the Wolfram Alpha API. It enables chat-based applications to perform computational queries and retrieve structured knowledge, facilitating advanced conversational capabilities.
  4. Included is an MCP-Client example utilizing Gemini via LangChain, demonstrating how to connect large language models to the MCP server for real-time interactions with Wolfram Alpha’s knowledge engine.
  5. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/akalaric/mcp-wolframalpha)
  6. ---
  7. ## Features
  8. - **Wolfram|Alpha Integration** for math, science, and data queries.
  9. - **Modular Architecture** Easily extendable to support additional APIs and functionalities.
  10. - **Multi-Client Support** Seamlessly handle interactions from multiple clients or interfaces.
  11. - **MCP-Client example** using Gemini (via LangChain).
  12. - **UI Support** using Gradio for a user-friendly web interface to interact with Google AI and Wolfram Alpha MCP server.
  13. ---
  14. ## Installation
  15. ### Clone the Repo
  16. ```bash
  17. git clone https://github.com/ricocf/mcp-wolframalpha.git
  18. cd mcp-wolframalpha
  19. ```
  20. ### Set Up Environment Variables
  21. Create a .env file based on the example:
  22. - WOLFRAM_API_KEY=your_wolframalpha_appid
  23. - GeminiAPI=your_google_gemini_api_key *(Optional if using Client method below.)*
  24. ### Install Requirements
  25. ```bash
  26. pip install -r requirements.txt
  27. ```
  28. Install the required dependencies with uv:
  29. Ensure [`uv`](https://github.com/astral-sh/uv) is installed.
  30. ```bash
  31. uv sync
  32. ```
  33. ### Configuration
  34. To use with the VSCode MCP Server:
  35. 1. Create a configuration file at `.vscode/mcp.json` in your project root.
  36. 2. Use the example provided in `configs/vscode_mcp.json` as a template.
  37. 3. For more details, refer to the [VSCode MCP Server Guide](https://sebastian-petrus.medium.com/vscode-mcp-server-42286eed3ee7).
  38. To use with Claude Desktop:
  39. ```json
  40. {
  41. "mcpServers": {
  42. "WolframAlphaServer": {
  43. "command": "python3",
  44. "args": [
  45. "/path/to/src/core/server.py"
  46. ]
  47. }
  48. }
  49. }
  50. ```
  51. ## Client Usage Example
  52. This project includes an LLM client that communicates with the MCP server.
  53. #### Run with Gradio UI
  54. - Required: GeminiAPI
  55. - Provides a local web interface to interact with Google AI and Wolfram Alpha.
  56. - To run the client directly from the command line:
  57. ```bash
  58. python main.py --ui
  59. ```
  60. #### Docker
  61. To build and run the client inside a Docker container:
  62. ```bash
  63. docker build -t wolframalphaui -f .devops/ui.Dockerfile .
  64. docker run wolframalphaui
  65. ```
  66. #### UI
  67. - Intuitive interface built with Gradio to interact with both Google AI (Gemini) and the Wolfram Alpha MCP server.
  68. - Allows users to switch between Wolfram Alpha, Google AI (Gemini), and query history.
  69. ![UI](configs/gradio_ui.png)
  70. #### Run as CLI Tool
  71. - Required: GeminiAPI
  72. - To run the client directly from the command line:
  73. ```bash
  74. python main.py
  75. ```
  76. #### Docker
  77. To build and run the client inside a Docker container:
  78. ```bash
  79. docker build -t wolframalpha -f .devops/llm.Dockerfile .
  80. docker run -it wolframalpha
  81. ```
  82. ## Contact
  83. Feel free to give feedback. The e-mail address is shown if you execute this in a shell:
  84. ```sh
  85. printf "\x61\x6b\x61\x6c\x61\x72\x69\x63\x31\x40\x6f\x75\x74\x6c\x6f\x6f\x6b\x2e\x63\x6f\x6d\x0a"
  86. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.