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 的方式編寫。

📷 截圖