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 编写。

截图

</中文翻译>