Skip to content

MCP server for checking Mathematica code via local MMA installation

Notifications You must be signed in to change notification settings

benhaotang/mcp-mma-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mathematica Documentation MCP server

General & Usage

Made with FastMCP

Requirements: pip install -r requirements.txt and have Mathematica installed (or at least wolframscript callable from terminal, e.g. via free wolfram engine for developers).

Run fastmcp dev path/to/mcp-mma-doc.py to initialize the server.

Run fastmcp install path/to/mcp-mma-doc.py to install to claude or add following to claude/cline config:

"mathematica-docs": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "/path/to/mcp-mma-doc.py"
      ]
    }
  • If you need custom path to wolframscript, you can set via changing line 6 in the python file wolframscript='wolframscript' to wolframscript='/path/to/wolframscript'.

Tools

The plugin provides the following commands:

  • get_docs: support factory functions, function via an addon, and function via a package.
    • Basic usage: get_docs("Plot")
    • With package: get_docs("WeightSystem", packages=["LieART"])
    • With addon: get_docs("FCFeynmanParametrize", packages=["FeynCalc"], load_addons=["FeynArts"])
  • list_package_symbols: list all symbols/functions in a package.
    • Basic usage: list_package_symbols("FeynCalc")

Known issues

  • If you see things like INFO Processing request of type __init__.py:431 ListToolsRequest in cline, you can ignore them as this will not affect it from working, this is due to current incomplete impliementation of the function discription and listing support via current usage of FastMCP.
  • Some MMA docs may contain complex styling format, and is not easy to remove with simple regex, your llm may be influenced by this, please instruct it to ignore the styling format and write in InputForm only.

Screenshots

screenshot

About

MCP server for checking Mathematica code via local MMA installation

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages