MCP Mma Docs

🚀 Mathematica 文档 MCP 服务器

本项目借助 mcp-python-sdk 构建，旨在为用户提供 Mathematica 文档相关的 MCP 服务器功能，帮助用户更便捷地使用 Mathematica 相关工具和获取文档信息。

🚀 快速开始

环境要求

运行 pip install -r requirements.txt 并安装 Mathematica（或至少确保 wolframscript 可从终端调用，例如通过 免费的 Wolfram 引擎开发者版）。

服务器初始化

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

安装到 Claude

要安装到 Claude，请运行 mcp install path/to/mcp-mma-doc.py，或在 Claude 或 cline 配置中添加以下内容：

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

⚠️ 重要提示

如果您仍在使用 FastMCP 版本的此 MCP 服务器，请考虑重新拉取此仓库并更新到最新版本，因为 FastMCP 已经被弃用。

💡 使用建议

目前使用 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

支持工厂函数、通过 Addon 加载的函数和通过包加载的函数。

# 查询 Plot 函数的文档
get_docs("Plot")

list_package_symbols

列出包中的所有符号/函数。

# 列出 FeynCalc 包中的所有符号/函数
list_package_symbols("FeynCalc")

高级用法

get_docs 包含包和 Addon 的情况

# 查询 WeightSystem 函数，指定包为 LieART
get_docs("WeightSystem", packages=["LieART"])
# 查询 FCFeynmanParametrize 函数，指定包为 FeynCalc，加载的 Addon 为 FeynArts
get_docs("FCFeynmanParametrize", packages=["FeynCalc"], load_addons=["FeynArts"])

📚 详细文档

工具命令详情

• get_docs：支持工厂函数、通过 Addon 加载的函数和通过包加载的函数。可以根据需要指定 packages 和 load_addons 参数。
• list_package_symbols：列出指定包中的所有符号/函数。

🔧 技术细节

已知问题

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

📷 截图