Mathematica MCP

🚀 Mathematica MCP 服务器

本项目提供了一个模型上下文协议（MCP）服务器，用于与 Wolfram Mathematica 内核进行交互。它允许大语言模型（LLMs）在安全的基于会话的环境中执行 Wolfram 语言代码。

animalid 文件夹包含一个简单的工具，用于生成基于动物的唯一标识符。由于大语言模型通常无法正确复制 UUID，此工具将其替换为更有可能被准确转录的动物主题 ID。

✨ 主要特性

• 提供与 Wolfram Mathematica 内核交互的 MCP 服务器。
• 允许大语言模型在安全会话环境中执行 Wolfram 语言代码。
• 提供基于动物的唯一标识符生成工具，方便大语言模型准确处理。

📦 安装指南

前提条件

• Python 3.10 或更高版本。
• uv Python 包管理器。（安装指南）
• 本地安装 Wolfram 引擎或 Mathematica。wolframclient 库需要此依赖才能正常工作。

安装步骤

1. 设置安全密钥： 此服务器使用一个密钥来生成安全的会话 ID。你必须将其设置为环境变量。

   export ANIMALID_SECRET_KEY='your-super-secret-and-long-key-here'
   

   注意：不要使用弱密钥，也不要将其硬编码在脚本中。

💻 使用示例

基础用法

要使用此服务器，你需要将其连接到与 MCP 兼容的客户端，例如桌面版 Claude。

1. 配置 MCP 客户端： 打开客户端的 MCP 配置文件（例如，桌面版 Claude 的 claude_desktop_config.json），并添加以下服务器配置。 重要：将 /path/to/your/project/my_mcp 替换为该项目在你系统上的绝对路径。

   {
     "mcpServers": {
       "mathematica": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/your/project/my_mcp",
           "run",
           "wolfram_mathematica.py"
         ],
          "env": {
               "ANIMALID_SECRET_KEY": "default-secret-key-for-dev"
             }
       }
     }
   }
   

   如果 uv 可执行文件不在系统的 PATH 中，你可能需要在 command 字段中使用其完整路径。你可以通过运行 which uv（macOS/Linux）或 where uv（Windows）来找到它。

📚 详细文档

提供的工具

1. create_mathematica_session：初始化一个新的 Wolfram 语言会话，并返回一个唯一的会话 ID。
2. execute_mathematica_code：在指定的会话中执行 Wolfram 语言代码。
3. close_mathematica_session：终止会话并释放其资源。

📷 截图