Skip to content

Repository files navigation

Mathematica MCP Server

codecov Build Python Version License PyPI version

MCP server that wraps Mathematica's wolframscript command-line interface. It provides tools to evaluate Wolfram Language code and retrieve information about the Wolfram Engine installation.

Tool Description
evaluate Evaluates a Wolfram Language script
version_wolframscript Returns version of wolframscript
version_wolframengine Returns version of Wolfram Engine
licensetype Returns license type of Wolfram Engine

Background

  • Wolfram Language: symbolic programming language e.g. Integrate[x*Sin[x], x]
  • Wolfram Engine: kernel for running Wolfram Language code
  • WolframScript: command-line interface to Wolfram Engine
  • Mathematica: notebook interface to Wolfram Engine

Both Wolfram Engine and WolframScript are freely available for personal use.

Installation

  1. Please ensure WolframScript is installed and activated on your system.
wolframscript -version
wolframscript -activate
wolframscript -code "Integrate[x*Sin[x], x]"
  1. Install the uv package manager.
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Edit the Claude Desktop config file and add the mathematica-mcp server. Note that uvx sets up an environment, installs the mathematica-mcp package, and runs the server by calling the mathematica-mcp entry point defined in pyproject.toml. No cloning of the repository is necessary. The logs are written to the default user log directory, e.g. ~/Library/Logs/mathematica_mcp/mathematica_mcp.log on macOS.
{
  "mcpServers": {
    "mathematica-mcp": {
      "command": "uvx",
      "args": [
        "mathematica-mcp"
      ]
    }
  }
}

Claude Desktop config file on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  1. Alternatively, you can clone the repository and then modify or extend the MCP server code. In this case, make sure to update the path to the local repository in the Claude Desktop config file.
{
  "mcpServers": {
    "mathematica-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/lars/Code/mathematica-mcp",
        "run",
        "mathematica-mcp"
      ]
    }
  }
}

Claude Desktop config file on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

About

MCP server for WolframScript

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages