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：終止會話並釋放其資源。

📷 截圖