Mathematica Documentation MCP server

Mathematica Documentation MCP server

site icon
2025.03.16 5
PythonMathematica 文档查询函数文档包符号列表开发效率
mcp-mma-docs 是一个基于 Mathematica 文档的 MCP 服务器,主要用于提供 Mathematica 函数的文档查询和包符号列表功能。它支持通过工厂函数、包或插件来获取函数的详细文档,并能列出特定包中的所有符号或函数。
View on GitHub

Overview

基本能力

产品定位

mcp-mma-docs 是一个专门为 Mathematica 用户设计的文档查询工具,旨在提供快速、便捷的函数文档访问和包符号列表功能。

核心功能

  • 文档查询:支持通过工厂函数、包或插件来获取 Mathematica 函数的详细文档。
  • 符号列表:能够列出特定包中的所有符号或函数。

适用场景

  • 开发者在编写 Mathematica 代码时需要快速查阅函数文档。
  • 需要了解特定包中包含的所有符号或函数。

工具列表

  • get_docs:获取 Mathematica 函数的文档。
  • 基本用法: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 的信息,可以忽略,这不会影响功能。
  • 某些 Mathematica 文档可能包含复杂的样式格式,可能会影响 LLM 的输出,建议指示 LLM 忽略样式格式并仅以 InputForm 编写。

使用教程

使用依赖

  1. 安装依赖:pip install -r requirements.txt
  2. 确保已安装 Mathematica 或至少可以从终端调用 wolframscript(可通过 免费 Wolfram 引擎 获取)。

安装教程

  1. 初始化服务器:mcp dev path/to/mcp-mma-doc.py
  2. 安装到 claude 或添加以下配置到 claude/cline 配置文件中:
"mathematica-docs": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp",
    "mcp",
    "run",
    "/path/to/mcp-mma-doc.py"
  ]
}

调试方式

  • 如果使用 uvmcp 在某些 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"
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。