Desmos MCP

🚀 Desmos-MCP 服務器

這是一個標準的模型上下文協議（MCP）服務器，旨在為大語言模型（LLMs）提供強大的數學公式可視化和分析能力。它利用 sympy 進行本地渲染和計算，還可以選擇集成 Desmos API。

🚀 快速開始

若要獨立運行服務器進行測試，請在項目根目錄執行以下命令：

uv run src/main.py

服務器將通過標準輸入/輸出（stdio）啟動，並準備好由 MCP 客戶端（如 Gemini CLI）連接。

✨ 主要特性

• 交互式公式驗證：使用 validate_formula 工具檢查數學公式的語法。如果公式無效，它會利用大語言模型的採樣功能，以通俗易懂的方式解釋錯誤原因。
• 單函數繪圖：使用 plot_math_function 工具從公式生成二維繪圖。它支持使用 Desmos API（可通過 config.json 配置），若不可用則回退到本地 matplotlib 渲染，並在執行過程中提供進度報告。
• 多函數繪圖：使用 plot_multiple_functions 工具在同一圖表上繪製多個函數。
• 符號分析：使用 analyze_formula 工具計算公式的數學屬性，如定義域、值域和臨界點。
• 將繪圖保存到文件：自動將生成的繪圖以 PNG 文件形式保存到桌面的 Desmos-MCP 文件夾中。

🔧 技術細節

• Python 3.10+
• FastMCP
• Sympy
• Matplotlib
• HTTPX

📦 安裝指南

1. 克隆項目（若尚未完成）
2. 安裝 uv 若未安裝 uv，請在終端運行以下命令：

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

3. 創建虛擬環境 在項目根目錄下運行：

   uv venv
   

4. 安裝依賴項

   uv sync
   

   此命令將根據 pyproject.toml 文件安裝所有必要的依賴項。

🔧 配置

服務器的行為由項目根目錄下的 config.json 文件控制。

{
  "desmos": {
    "use_api": true,
    "api_key_env_var": "DESMOS_API_KEY",
    "fallback_to_local": true
  },
  "rendering": {
    "default_width": 600,
    "default_height": 400
  }
}

• desmos.use_api：若為 true，服務器將首先嚐試使用 Desmos API 進行繪圖。
• desmos.api_key_env_var：指定用於獲取 Desmos API 密鑰的環境變量名稱。
• desmos.fallback_to_local：若 use_api 為 true 但 API 調用失敗，此選項決定服務器是否應自動回退到本地渲染。

設置 Desmos API 密鑰（可選）

要使用 Desmos API 功能，您需要設置一個環境變量。例如，在 PowerShell 中：

$env:DESMOS_API_KEY="your_actual_api_key_here"

📝 待辦事項

• [ ] 添加 3D 繪圖支持。
• [ ] 實現即時公式分析和交互式繪圖，類似於 Desmos。

📄 許可證

本項目採用 Apache 2.0 許可證。詳情請參閱 LICENSE 文件。