Mathematica MCP Server

This project provides a Model Context Protocol (MCP) server for interacting with a Wolfram Mathematica kernel. It allows Large Language Models (LLMs) to execute Wolfram Language code in a secure, session-based environment.

The animalid folder contains a simple tool for generating unique, animal-based identifiers. Since LLMs often fail to copy UUIDs correctly, this tool replaces them with animal-themed IDs that are more likely to be transcribed accurately.

Tools Provided

1. create_mathematica_session: Initializes a new Wolfram Language session and returns a unique session ID.
2. execute_mathematica_code: Executes Wolfram Language code within a specified session.
3. close_mathematica_session: Terminates a session and releases its resources.

Prerequisites

• Python 3.10 or higher.
• uv Python package manager. (Installation guide)
• A local installation of the Wolfram Engine or Mathematica. The wolframclient library requires this to function.

Installation & Setup

1. Set the Security Key:

   This server uses a secret key to generate secure session IDs. You must set this as an environment variable.

   export ANIMALID_SECRET_KEY='your-super-secret-and-long-key-here'
   

   Note: Do not use a weak key or hardcode it in the script.

Usage

To use this server, you need to connect it to an MCP-compatible client, such as Claude for Desktop.

1. Configure the MCP Client:

   Open your client's MCP configuration file (e.g., claude_desktop_config.json for Claude for Desktop) and add the following server configuration.

   Important: Replace /path/to/your/project/my_mcp with the absolute path to this project's directory on your system.

   {
     "mcpServers": {
       "mathematica": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/your/project/my_mcp",
           "run",
           "wolfram_mathematica.py"
         ],
          "env": {
               "ANIMALID_SECRET_KEY": "default-secret-key-for-dev"
             }
       }
     }
   }
   

   You may need to use the full path to the uv executable in the command field if it's not in your system's PATH. You can find it by running which uv (macOS/Linux) or where uv (Windows).

screenshot