cloudtasks-mcp

🚀 Cloud Tasks MCP 服务

Cloud Tasks MCP 服务是一个用于与 Google Cloud Tasks 交互的模型上下文协议（MCP）服务器，支持对队列和任务的操作，能高效管理 Google Cloud Tasks 中的队列与任务。

✨ 主要特性

• 列出指定位置下的所有 Cloud Tasks 队列
• 获取特定队列的详细信息
• 暂停和恢复队列
• 列出队列中的任务
• 获取特定任务的详细信息
• 从队列中删除任务

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 自动为 Claude 桌面版安装 Cloud Tasks Server：

npx -y @smithery/cli install @gitskyflux/cloudtasks-mcp --client claude

手动安装

1. 安装依赖项：

   npm install
   

2. 构建项目：

   npm run build
   

3. 配置 Claude 桌面版： 在 claude_desktop_config.json 中添加以下内容：

   "cloudtasks-mcp": {
     "command": "node",
     "args": [
       "/path/to/cloudtasks-mcp/build/index.js"
     ],
     "env": {
       "GOOGLE_CLOUD_LOCATION_PROJECTS": "location:project-id"
     }
   }
   

   • 将 args 中的路径替换为实际的 index.js 路径。
   • 使用逗号分隔的形式定义 location:project-id 对的列表，例如：us-east1:google-project-id1,us-central1:google-project-id2，第一个列出的项目是默认项目。
   • 应用程序期望在 keys 文件夹中为每个项目找到相应的 .json 凭证文件，示例路径：keys/google-project-id1.json。
   • 确保相关云服务帐号具有适当的权限以与 Cloud Tasks 交互，例如 Cloud Tasks Admin 或更少的权限。

可用工具

• listQueues：列出指定位置下的所有 Cloud Tasks 队列
• getQueue：获取特定队列的详细信息
• pauseQueue：暂停某个 Cloud Tasks 队列
• resumeQueue：恢复 paused 的 Cloud Tasks 队列
• listTasks：列出队列中的任务
• getTask：获取特定任务的详细信息
• deleteTask：从队列中删除某个任务

💻 使用示例

基础用法（Claude 桌面版）

以下是每个工具在 Claude 桌面版中使用的示例：

暂停或恢复队列

暂停 special-events 队列。恢复 special-events 队列。

获取待处理任务数量

special-events 队列中有多少个任务正在等待？

执行 paused 队列中的任务

在特殊事件队列中执行以 ID 123456 结尾的任务。

开发

# 监视模式
npm run dev