Mathematica文档服务器

一个基于MCP协议的Mathematica文档查询服务器,提供函数文档查询和包符号列表功能。

  • by benhaotang
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 benhaotang/mcp-mma-docs

使用说明

Mathematica文档MCP服务器

一般与使用

由以下材料制成 mcp-python-sdk

[!重要]
如果您仍在使用此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"
      ]
    }

[!注意] 目前正在使用 uv 随着 mcp 似乎破坏了某些Linux/macOS版本的Claude桌面,您可能需要设置为:

"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"

或设置为 env 键入mcp配置

"mathematica-docs": {
      "command": ...,
      "args": ....
      "env": {
        "WOLFRAMSCRIPT_PATH": "/usr/bin/wolframscript"
      }
    }

工具

该插件提供以下命令:

  • get_docs:支持工厂函数、通过插件的函数和通过包的函数。
    • 基本用法:get_docs(“Plot”)
    • 使用package:get_docs(“权重系统”,packages=[“LieART”])
    • 使用插件:get_docs(“FCFeynmanParameter”,packages=[“FeynCalc”],load_addons=[”FeynArts“])
  • list_package_symbols:列出包中的所有符号/函数。
    • 基本用法:list_package_symbols(“FeynCalc”)

已知问题

  • 如果你看到这样的事情 INFO Processing request of type __init__.py:431 ListToolsRequest 在cline中,您可以忽略它们,因为这不会影响它的工作,这是因为cline解析工具列表以及控制台调试信息,而当前的pythonsdk无法禁用控制台消息。除了看到此警告外,这不会影响任何函数调用部分。
  • 一些MMA文档可能包含复杂的样式格式,并且不容易用简单的正则表达式删除,您的llm可能会受到影响,请指示它忽略样式格式,只在InputForm中编写。

截图