mcp-mma-docs

This MCP server provides automatic Mathematica/Wolfram documentation generation. It uses the Python-based MCP SDK to expose functions that generate docs for Mathematica symbols, packages, and add-ons. The available tools include get_docs for retrieving documentation from a symbol, package, or addon, and list_package_symbols to enumerate all symbols within a given package. To run the server, use the MCP runner (e.g., uv-based setup) and point it at the mcp-mma-doc.py script. Once running, you can query the server using the standard MCP tooling to fetch documentation for Mathematica functions or packages, or to list symbols for a package such as FeynCalc or LieART. Note that you may need a working Wolfram environment (wolframscript) for documentation extraction, and you can configure the path to wolframscript if it’s not in your system PATH.

Prerequisites:

• Python 3.8+ and pip
• Mathematica installed or wolframscript accessible from the command line
• Network access if dependencies must be fetched

1. Clone the repository or download the project files.
2. Create and activate a Python virtual environment (optional but recommended):
   • python -m venv venv
   • source venv/bin/activate # on macOS/Linux
   • venv\Scripts\activate # on Windows
3. Install Python dependencies:
   • pip install -r requirements.txt
4. Ensure wolframscript is accessible. If it’s not in PATH, set the path via an environment variable or MCP config (WOLFRAMSCRIPT_PATH).
5. Run the MCP server in development mode (example):
   • mcp dev path/to/mcp-mma-doc.py
6. To install or configure in Claude, use the provided installation snippet and adjust the command to your environment (uv-based or direct mcp path as needed).

Notes:

• If you’re using uv in Claude, you may need to adjust the command path to the mcp wrapper as described in the README to avoid platform-specific CLI parsing issues.
• Ensure you have the required Mathematica tooling available and properly licensed where applicable.

Tips and caveats:

• Environment variable: If wolframscript isn’t in your PATH, set WOLFRAMSCRIPT_PATH in the MCP config or export it in your shell before starting the server.
• When installing via Claude, if you encounter issues with the uv-based command on certain Linux/macOS setups, switch to invoking the exact mcp executable path as shown in the README snippet.
• This server relies on the Python SDK; you may see some verbose console output related to the cline tool. It does not affect documentation retrieval or function calls.
• Keep your Mathematica/Wolfram environment up to date to ensure compatibility with the generated documentation.