工具 - 项目

用于列出、查询、创建和更新项目的工具。

---

list_projects

列出所有项目，并支持可选的分页。如果 MCP 会话中配置了 projectId，则仅返回该项目。

参数：

名称	类型	必填	描述
page	number	否	页码（默认值：1）
limit	number	否	每页项目数（默认值：50，最大值：100）

示例：

{
  "page": 1,
  "limit": 10
}

响应：

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "My Project",
      "description": "Project description",
      "status": "active",
      "createdAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}

---

get_project

根据 ID 获取项目，包括关联的看板、文档链接和备注。

参数：

名称	类型	必填	描述
id	string (UUID)	是	项目 ID

示例：

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

响应：

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Project",
  "description": "Project management platform",
  "status": "active",
  "boards": [],
  "docLinks": [],
  "notes": [],
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-20T14:30:00.000Z"
}

---

create_project

创建新项目。名称为必填项。

参数：

名称	类型	必填	描述
name	string	是	项目名称
description	string	否	项目描述
status	string	否	项目状态：active、archived、on_hold

示例：

{
  "name": "New Project",
  "description": "Internal management app",
  "status": "active"
}

响应：

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "New Project",
  "description": "Internal management app",
  "status": "active",
  "createdAt": "2025-02-01T09:00:00.000Z"
}

---

update_project

更新现有项目的字段。仅更新已提供的字段。

参数：

名称	类型	必填	描述
id	string (UUID)	是	要更新的项目 ID
name	string	否	新名称
description	string	否	新描述
status	string	否	新状态：active、archived、on_hold

示例：

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "archived"
}

响应：

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Project",
  "description": "Project management platform",
  "status": "archived",
  "updatedAt": "2025-02-10T16:00:00.000Z"
}

---

get_project_roadmap

获取项目路线图，其中包含层级结构（史诗、功能、用户故事/任务）以及根据工作项活动计算的日期。

日期根据看板上的列移动事件计算：

• startDate：项目首次移至活跃列的时间
• endDate：项目移至“done”列的时间
• 父项目会汇总其子项目的日期

参数：

名称	类型	必填	描述
projectId	string (UUID)	是	项目 ID（回退使用 MCP 会话 ID）

示例：

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

响应：

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "id": "...",
      "taskId": "A-E-1",
      "title": "Epic: Authentication",
      "type": "epic",
      "startDate": "2025-01-20T10:00:00.000Z",
      "endDate": null,
      "children": [
        {
          "id": "...",
          "taskId": "A-F-3",
          "title": "Feature: Google Login",
          "type": "feature",
          "startDate": "2025-01-20T10:00:00.000Z",
          "endDate": "2025-01-25T18:00:00.000Z",
          "children": []
        }
      ]
    }
  ]
}

推荐用法

get_project_roadmap 非常适合 AI 代理在规划新工作前概览项目状态。