关于 ithura
ithura 是用于管理 Ithura 项目工作区的 MCP 服务。团队可通过结构化 JSON 工具,让 MCP 客户端读取和更新任务、项目、冲刺、模块及 Wiki 页面。
主要功能
- 01读取和更新项目
- 02创建、更新和删除任务
- 03管理冲刺及任务归属
- 04创建和管理模块
- 05搜索工作区内容
- 06管理标签和任务评论
适用场景
- 01查看冲刺中尚未完成的任务
- 02为报告的缺陷创建任务
- 03汇总一段时间内完成的任务
- 04搜索工作区中的工作内容
MCP 相关
通过 API 令牌和工作区标识连接 MCP 客户端与 Ithura 工作区,并提供 23 个工具来读取和写入工作区数据。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y ithura-mcpITHURA_API_KEY密钥Workspace API token, created under Settings > API tokens. Carries the permissions of the member who created it.ITHURA_WORKSPACE_SLUGThe workspace slug, as it appears in your Ithura URL.ITHURA_API_URLAPI base URL. Defaults to https://api.ithura.com; set this when self-hosting.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
23收录的工具列表 · 更新于 3 周前
此工具无需参数。
详细介绍
Ithura MCP 服务
这是一个面向 Ithura 的 Model Context Protocol 服务。Ithura 是一个让团队专注协作的简约项目管理工作空间。
将 Claude、Cursor 或任何 MCP 客户端连接到你的 Ithura 工作空间,即可让它读取和编写实际工作内容:任务、迭代、项目、模块、Wiki 页面和需求收集。
"What is left in the current sprint?"
"Create a task for the login timeout bug and put it in this sprint."
"Summarise every task that moved to Done this week."
已列入官方 MCP Registry,名称为 com.ithura/mcp。
安装
无需安装。将 MCP 客户端指向 npx:
npx ithura-mcp
Claude Desktop / Claude Code
将以下内容添加到 MCP 设置中(claude_desktop_config.json,或 Claude Code 项目中的 .mcp.json):
{
"mcpServers": {
"ithura": {
"command": "npx",
"args": ["-y", "ithura-mcp"],
"env": {
"ITHURA_API_KEY": "your-api-token",
"ITHURA_WORKSPACE_SLUG": "your-workspace"
}
}
}
}
Cursor
~/.cursor/mcp.json 使用相同的配置块。
配置
| 变量 | 必需 | 默认值 | 说明 |
|---|---|---|---|
ITHURA_API_KEY | 是 | 工作空间 API 令牌,可在 Settings > API tokens 中获取 | |
ITHURA_WORKSPACE_SLUG | 是 | 工作空间 URL 中的 slug | |
ITHURA_API_URL | 否 | https://api.ithura.com | 自托管时,指向你自己的主机 |
在 Ithura 的 Settings > API tokens 中创建令牌。令牌具有创建者的权限,因此请使用权限范围符合你希望 Agent 拥有的访问权限的用户来创建令牌。
工具
涵盖工作关系图的 23 个工具:
| 类别 | 工具 |
|---|---|
| 项目 | list_projects、get_project、create_project、update_project |
| 任务 | list_issues、get_issue、create_issue、update_issue、delete_issue |
| 评论 | list_issue_comments、add_issue_comment |
| 迭代 | list_cycles、create_cycle、add_issues_to_cycle、remove_issue_from_cycle |
| 模块 | list_modules、create_module、add_issues_to_module、delete_module |
| 元数据 | list_states、list_labels、create_label |
| 搜索 | search_workspace |
每个工具都返回 JSON,因此模型看到的是实际字段值,而不是文字描述。
说明
- HTTP API 中工作项的名称是
issue;产品中称其为任务。工具名称遵循 API 的命名。 - 写入操作会实际生效。如果希望限制 Agent 在工作空间中的操作范围,可以使用仅对成员开放有限项目访问权限的令牌。
- 自托管:将
ITHURA_API_URL设为你的实例地址,其他配置无需更改。
链接
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。