Modal MCP Server

🚀 Modal MCP 服務器

Modal MCP 服務器用於與 Modal 卷交互，還能從 Cursor 內部部署 Modal 應用程序，為相關操作提供了便利的實現方案。

🚀 快速開始

要使用 Modal MCP 服務器，你需要完成安裝和配置步驟，以下是詳細說明。

📦 安裝指南

1. 克隆此倉庫：

git clone https://github.com/smehmood/modal-mcp-server.git
cd modal-mcp-server

2. 使用 uv 安裝依賴項：

uv sync

📚 詳細文檔

配置說明

要在 Cursor 中使用此 MCP 服務器，請將以下配置添加到你的 ~/.cursor/mcp.json 文件中：

{
  "mcpServers": {
    "modal-mcp-server": {
      "command": "uv",
      "args": [
        "--project", "/path/to/modal-mcp-server",
        "run", "/path/to/modal-mcp-server/src/modal_mcp/server.py"
      ]
    }
  }
}

請將 /path/to/modal-mcp-server 替換為你克隆倉庫的實際絕對路徑。

先決條件

• Python 3.11 或更高版本
• uv 包管理器
• 配置了有效憑證的 Modal CLI
• 對於 Modal 部署支持：
  • 要部署的項目必須使用 uv 進行依賴管理
  • Modal 必須安裝在項目的虛擬環境中

支持工具

Modal 卷操作

1. 列出 Modal 卷 (list_modal_volumes)

   • 功能：列出環境中的所有 Modal 卷
   • 返回：JSON 格式的卷信息
   • 參數：無

2. 列出卷內容 (list_modal_volume_contents)

   • 功能：列出 Modal 卷中的文件和目錄
   • 參數：
     • volume_name：卷的名稱
     • path：卷內的路徑（默認: "/"）

3. 複製文件 (copy_modal_volume_files)

   • 功能：在 Modal 卷內複製文件
   • 參數：
     • volume_name：卷的名稱
     • paths：路徑列表，最後一個路徑為目的地
   • 示例：["source.txt", "dest.txt"] 或 ["file1.txt", "file2.txt", "dest_dir/"]

4. 刪除文件 (remove_modal_volume_file)

   • 功能：從 Modal 卷中刪除文件或目錄
   • 參數：
     • volume_name：卷的名稱
     • remote_path：要刪除的文件/目錄路徑
     • recursive：是否遞歸刪除的布爾標誌（默認: false）

5. 上傳文件 (put_modal_volume_file)

   • 功能：上傳文件或目錄到 Modal 卷
   • 參數：
     • volume_name：卷的名稱
     • local_path：要上傳的本地路徑
     • remote_path：卷內的目標路徑（默認: 當前目錄）

6. 下載文件 (get_modal_volume_file)

   • 功能：從 Modal 卷下載文件或目錄
   • 參數：
     • volume_name：卷的名稱
     • remote_path：要下載的卷內路徑
     • local_path：下載後保存到本地的路徑（默認: 當前目錄）

響應格式

• 成功響應：

{
  "status": "success",
  "result": {}
}

• 錯誤響應：

{
  "status": "error",
  // 此處原文檔未完整給出錯誤響應內容，保持原樣
}