使用说明
Taiga MCP服务器
全功能MCP（模型上下文协议）服务器 泰加 项目管理。提供对Taiga API v1的全面访问，使AI代理能够管理项目、史诗、用户故事、任务、问题、疾跑、wiki页面、成员资格、角色等。
特征
封面 全部 Taiganeneneba API v1端点：
- 项目 --CRUD、统计数据、标签、点赞、观看
- 史诗 --CRUD、批量创建、相关用户故事、投票、观看、附件
- 用户故事 --CRUD、批量操作、订购、投票、观看、附件
- 任务 --CRUD、批量创建、投票、观看、附件
- 问题 --CRUD、批量创建、投票、观看、附件
- 里程碑/冲刺 --CRUD、统计、观看
- 维基 --页面和链接CRUD、观看、附件
- 会员资格 --CRUD，批量邀请
- 角色 --带权限的CRUD
- 用户 --列表、获取、我、统计数据、联系人
- 状态 --US/任务/问题状态、类型、优先级、严重程度、点数
- 自定义属性 --史诗、用户故事、任务、问题的定义和价值
- 历史与评论 --更改历史记录，创建/删除评论
- 搜索 --全球项目搜索
- 时间线 --用户和项目时间表
- 解析器 --ID解析的Slug/ref
- 网络钩子 --CRUD、测试、日志
- 导出/导入 --项目进出口
设置
环境变量
| 变量 | 描述 |
|---|---|
TAIGA_URL |
Taiga实例URL（例如。 https://taiga.example.com) |
TAIGA_USERNAME |
Taiga用户名 |
TAIGA_PASSWORD |
Taiga密码 |
MCP客户端配置（推荐）
使用此服务器的最简单方法是通过 npx --无需安装：
{
"mcpServers": {
"taiga": {
"command": "npx",
"args": ["-y", "@illodev/taiga-mcp"],
"env": {
"TAIGA_URL": "https://taiga.example.com",
"TAIGA_USERNAME": "your-user",
"TAIGA_PASSWORD": "your-pass"
}
}
}
}
VS代码/GitHub副本 --将上面的条目添加到您的
mcp.json.
克劳德桌面 --添加到下面mcpServers在claude_desktop_config.json.
Docker Compose
cp .env.example .env
# Edit .env with your Taiga credentials
docker compose up --build
本地开发
pnpm install
pnpm run dev
构建
pnpm run build
pnpm start
代理自定义
该项目包括GitHub Copilot下的即用型定制 .github/ 因此，您的AI代理可以与Taiga MCP工具有效地协同工作。
.github/
├── agents/ # Custom agents (10)
│ ├── taiga-project-manager.agent.md # Orchestrator — delegates to sub-agents
│ ├── taiga-user-stories.agent.md # User story CRUD, backlog, story points
│ ├── taiga-tasks.agent.md # Task CRUD, statuses, comments
│ ├── taiga-issues.agent.md # Bug triage & issue classification
│ ├── taiga-epics.agent.md # Epic CRUD, story-to-epic linking
│ ├── taiga-sprints.agent.md # Sprint lifecycle & burndown
│ ├── taiga-wiki.agent.md # Wiki pages, links, history
│ ├── taiga-team.agent.md # Members, roles, permissions
│ ├── taiga-reporter.agent.md # Project reports & analytics (read-only)
│ └── taiga-project-setup.agent.md # Project config, webhooks, export/import
├── instructions/ # Context-aware guidelines
│ ├── taiga-mcp-usage.instructions.md # Tool naming, ID resolution, common patterns
│ ├── taiga-workflows.instructions.md # Scrum/Kanban recipes, feature flows
│ └── taiga-orchestration.instructions.md # Agent delegation & coordination
└── skills/ # On-demand workflow skills
├── sprint-planning/SKILL.md # Create & manage sprints
├── backlog-grooming/SKILL.md # Refine stories, epics, and points
├── issue-triage/SKILL.md # Classify and prioritize issues
├── project-setup/SKILL.md # Configure a new project from scratch
├── project-reporting/SKILL.md # Generate stats and reports
├── team-management/SKILL.md # Manage members, roles, permissions
└── wiki-documentation/SKILL.md # Create and organize wiki pages
自定义代理
| 代理 | 角色 | 调用 |
|---|---|---|
| Taiga项目经理 | Orchestrator——委托给专门的代理，解析上下文 | @Taiga Project Manager |
| Taiga用户故事 | 用户故事CRUD、积压/看板排序、故事点、评论 | @Taiga User Stories |
| 泰加任务 | 任务CRUD、任务状态、注释、自定义属性 | @Taiga Tasks |
| 泰加问题 | Bug分类、问题分类、严重性/优先级管理 | @Taiga Issues |
| 泰加史诗 | 史诗级CRUD、故事到史诗级链接、史诗级自定义属性 | @Taiga Epics |
| 泰加精灵 | Sprint生命周期、燃尽统计、里程碑管理 | @Taiga Sprints |
| Taiga维基 | Wiki页面CRUD、导航链接、评论、历史记录 | @Taiga Wiki |
| 泰加团队 | 成员邀请、角色管理、用户配置文件 | @Taiga Team |
| 泰加记者 | 项目报告、燃尽分析、团队活动总结（只读） | @Taiga Reporter |
| Taiga项目设置 | 项目创建、状态/工作流配置、webhooks、导出/导入 | @Taiga Project Setup |
技能（斜线命令）
| 技能 | 描述 |
|---|---|
/sprint-planning |
计划冲刺、分配故事、追踪烧毁情况 |
/backlog-grooming |
创作史诗、提炼故事、设定点、订购积压订单 |
/issue-triage |
创建并分类具有优先级/严重性的问题 |
/project-setup |
使用状态、角色、标签和自定义属性设置新项目 |
/project-reporting |
生成冲刺、项目和团队报告 |
/team-management |
邀请成员、分配角色、管理权限 |
/wiki-documentation |
创建和组织wiki页面和导航 |
扩展文档
有关详细指南和示例，请参阅 docs/ 文件夹：
说明
相关时自动加载：
- 泰加mcp使用 --工具命名约定、ID解析模式、错误处理
- 泰加林工作流程 --Scrum冲刺、看板、功能开发、bug解决的现成食谱
- 泰加管弦乐 --代理委托模式与多域工作流协调
