Mathematica 文档 MCP 服务器

概述 & 用法

使用 mcp-python-sdk 构建

[!IMPORTANT] 如果您仍然在使用此 mcp 服务器的 FastMCP 版本，请考虑重新拉取此仓库并更新到较新版本，因为 FastMCP 已经弃用。

要求：pip install -r requirements.txt 并安装 Mathematica（或者至少可以从终端调用 wolframscript，例如通过 面向开发者的免费 Wolfram 引擎）。

运行 mcp dev path/to/mcp-mma-doc.py 以初始化服务器。

运行 mcp install path/to/mcp-mma-doc.py 以安装到 claude，或者将以下内容添加到 claude/cline 配置：

"mathematica-docs": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "/path/to/mcp-mma-doc.py"
      ]
    }

[!NOTE] 目前，将 uv 与 mcp 一起使用似乎会破坏某些 Linux/macOS 版本的 Claude-desktop，您可能需要将其设置为：

"mathematica-docs": {
      "command": "/path/to/mcp",
      "args": [
        "run",
        "/path/to/mcp-mma-doc.py"
      ]
    }

代替，其中 /path/to/mcp 是通过在终端中运行 which mcp 获得的

自定义 wolframscript 安装路径

如果您需要自定义 wolframscript 的路径，或者它不在系统路径中，您可以通过环境变量进行设置：

export WOLFRAMSCRIPT_PATH="/usr/bin/wolframscript"

或者将其设置为 mcp 配置中的 env 键：

"mathematica-docs": {
      "command": ...,
      "args": ....
      "env": {
        "WOLFRAMSCRIPT_PATH": "/usr/bin/wolframscript"
      }
    }

工具

该插件提供以下命令：

• get_docs：支持工厂函数、通过插件提供的函数以及通过包提供的函数。
  • 基本用法：get_docs("Plot")
  • 使用包：get_docs("WeightSystem", packages=["LieART"])
  • 使用插件：get_docs("FCFeynmanParametrize", packages=["FeynCalc"], load_addons=["FeynArts"])
• list_package_symbols：列出包中的所有符号/函数。
  • 基本用法：list_package_symbols("FeynCalc")

已知问题

• 如果您在 cline 中看到类似 INFO Processing request of type __init__.py:431 ListToolsRequest 的信息，您可以忽略它们，因为这不会影响其工作，这是因为 cline 将工具列表与控制台调试信息一起解析，并且当前的 python-sdk 无法禁用控制台消息。除了看到此警告之外，这不会影响任何函数调用部分。
• 某些 MMA 文档可能包含复杂的样式格式，并且不容易通过简单的正则表达式删除，您的 llm 可能会受到此影响，请指示它忽略样式格式并仅以 InputForm 编写。

截图