Modal MCP 服务器

用于与 Modal 卷交互并在 Cursor 中部署 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: Modal 卷的名称
     • path: 卷内的路径（默认："/"）

3. 复制文件 (copy_modal_volume_files)

   • 在 Modal 卷内复制文件
   • 参数：
     • volume_name: Modal 卷的名称
     • paths: 路径列表，最后一个路径是目标位置
   • 示例：["source.txt", "dest.txt"] 或 ["file1.txt", "file2.txt", "dest_dir/"]

4. 删除文件 (remove_modal_volume_file)

   • 从 Modal 卷中删除文件或目录
   • 参数：
     • volume_name: Modal 卷的名称
     • remote_path: 要删除的文件/目录的路径
     • recursive: 递归删除的布尔标志（默认：false）

5. 上传文件 (put_modal_volume_file)

   • 将文件或目录上传到 Modal 卷
   • 参数：
     • volume_name: Modal 卷的名称
     • local_path: 要上传的本地文件/目录的路径
     • remote_path: 卷内要上传到的路径（默认："/"）
     • force: 覆盖现有文件的布尔标志（默认：false）

6. 下载文件 (get_modal_volume_file)

   • 从 Modal 卷下载文件
   • 参数：
     • volume_name: Modal 卷的名称
     • remote_path: 卷内要下载的文件/目录的路径
     • local_destination: 下载文件保存的本地路径（默认：当前目录）
     • force: 覆盖现有文件的布尔标志（默认：false）
   • 注意：使用 "-" 作为 local_destination 可以将文件内容写入标准输出

Modal 部署

1. 部署 Modal 应用 (deploy_modal_app)
   • 部署 Modal 应用程序
   • 参数：
     • absolute_path_to_app: Modal 应用程序文件的绝对路径
   • 注意：包含 Modal 应用的项目必须：
     • 使用 uv 进行依赖管理
     • 在其虚拟环境中安装了 modal CLI

响应格式

所有工具均返回标准化格式的响应，具体取决于操作类型略有不同：

# JSON 操作（列出卷，列出内容）：
{
    "success": True,
    "data": {...}  # 来自 Modal CLI 的 JSON 数据
}

# 文件操作（上传，下载，复制，删除）：
{
    "success": True,
    "message": "操作成功消息",
    "command": "执行的命令字符串",
    "stdout": "命令输出",  # 如果有
    "stderr": "错误输出"     # 如果有
}

# 错误情况（所有操作）：
{
    "success": False,
    "error": "描述出错原因的错误消息",
    "command": "执行的命令字符串",  # 对于文件操作
    "stdout": "命令输出",  # 如果可用
    "stderr": "错误输出"     # 如果可用
}

贡献

欢迎贡献！请随时提交拉取请求。

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。