🚀 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的方式编写。