# 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](https://astral.sh/uv/install.sh))
- 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.
    
    ```bash
    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.
    
    ```json
    {
      "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
![screenshot](screenshot/1.png)