TeamRetro MCP 服务器

用于 TeamRetro 集成的模型上下文协议 (MCP) 服务器。

重要提示

非官方 MCP 服务器

此 MCP 服务器是社区开发的非官方 TeamRetro 服务接口。虽然它并非由 TeamRetro 开发或认可，但它提供了对其平台的标准化访问。

官方 API 集成

服务器直接连接到 TeamRetro 的官方公共 API：

使用 TeamRetro API 规范中记录的端点
保持完整的 API 合规性和版本跟踪
实现所有必需的身份验证方法
保留原始 API 响应而不进行修改

API 文档来源

所有 API 端点和功能均基于 TeamRetro 的官方文档：

API 帮助文章： https://help.teamretro.com/article/320-teamretro-api
API 规范： https://groupmap.stoplight.io/docs/teamretro/
实现严格遵循公共 API 规范
TeamRetro API 的任何更改都可能影响此 MCP 服务器的功能

如何使用

NPX（推荐，易于设置）

{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "npx",
      "args": ["-y", "teamretro-mcp-server"],
      "env": {
        "TEAMRETRO_AUTH_TYPE": "apiKey",
        "TEAMRETRO_API_KEY": "your-api-key"
      }
    }
  }
}

从源代码

克隆存储库、安装依赖项并构建项目：

git clone https://github.com/adepanges/teamretro-mcp-server.git
cd teamretro-mcp-server
npm install
npm run build

在AI客户端中运行

使用以下设置配置 AI 客户端：

{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "node",
      "args": ["/path/to/teamretro-mcp-server/dist/index.js"],
      "env": {
        "TEAMRETRO_AUTH_TYPE": "apiKey",
        "TEAMRETRO_API_KEY": "your-api-key"
      }
    }
  }
}

与 Inspector 一起运行

通过将.env.example复制到.env并根据需要进行修改来配置环境变量。
使用检查器运行服务器：

npm run inspector

环境变量示例

基本 URL

可以使用TEAMRETRO_BASE_URL环境变量设置 TeamRetro API 的基本 URL。默认情况下，它设置为https://api.teamretro.com 。

{
  "env": {
    "TEAMRETRO_BASE_URL": "https://api.teamretro.com"
  }
}

API 密钥认证

{
  "env": {
    "TEAMRETRO_AUTH_TYPE": "apiKey",
    "TEAMRETRO_API_KEY": "your-api-key"
  }
}

可用工具

该服务器提供以下工具：

用户

list_users ：使用偏移量和限制参数分页列出用户，以控制返回的结果数量
add_user ：通过电子邮件地址添加新用户或更新现有用户的信息，指定可选的姓名和电子邮件地址
update_user ：通过提供当前电子邮件来更新现有用户的详细信息，例如其姓名和电子邮件地址
delete_user ：通过电子邮件地址删除用户
get_user ：通过电子邮件地址检索单个用户的详细信息

团队

list_teams ：列出 TeamRetro 中的团队，按标签和 ID 进行过滤，并使用偏移量和限制参数进行分页
detail_team ：通过唯一 ID 检索单个团队的详细信息
update_team ：通过提供团队 ID 来更新现有团队的详细信息，例如其名称和相关标签
create_team ：创建一个具有必需名称以及可选标签和成员的新团队
delete_team ：通过 ID 删除现有团队

团队成员

list_team_members ：检索指定团队 ID 的团队成员列表，并使用偏移量和限制的分页控件
get_team_member ：通过电子邮件地址获取指定团队中的团队成员
update_team_member ：通过指定团队内的电子邮件地址更新团队成员的详细信息，例如其姓名或团队管理员状态
remove_team_member ：通过电子邮件地址从团队中删除团队成员
add_team_member ：通过电子邮件地址将新团队成员添加到团队，并可选择指定团队管理员状态

行动

list_actions ：从 TeamRetro 检索操作列表，可选择按团队标签和团队 ID 进行筛选，以及偏移量和限制的分页控件
create_action ：在 TeamRetro 中创建一个新操作，其中包含所需的详细信息，例如团队 ID、标题、截止日期、完成状态和分配的用户
get_action ：通过 TeamRetro 中的唯一 ID 获取单个动作
update_action ：使用新的详细信息（例如标题、截止日期、完成状态、优先级和分配用户）更新 TeamRetro 中的现有操作
delete_action ：通过操作 ID 从 TeamRetro 中删除现有操作

协议

list_agreements ：列出 TeamRetro 中的协议，并可选择按团队标签和团队 ID 进行筛选，以及分页控件
create_agreement ：在 TeamRetro 中创建新协议，指定其所属团队及其标题
get_agreement ：通过唯一标识符检索单个协议
update_agreement ：更新现有协议的详细信息，例如其标题或相关团队
delete_agreement ：通过指定唯一标识符删除现有协议

健康检查

list_health_checks ：列出 TeamRetro 的健康检查，并可选择按健康模型 ID、团队标签和团队 ID 进行筛选，以及分页控件
get_health_check ：通过唯一标识符检索单个健康检查，并包含可选属性
delete_health_check ：通过指定其唯一标识符删除现有的健康检查

健康模型

list_health_models ：使用分页控件列出 TeamRetro 的健康模型
get_health_model ：通过唯一标识符检索单个健康模型

回顾

list_retrospectives ：列出 TeamRetro 中的回顾，按团队标签和 ID 进行过滤，并使用偏移量和限制参数进行分页
get_retrospective ：通过唯一 ID 检索有关单个回顾的详细信息
delete_retrospective ：通过 ID 删除现有回顾

变更日志

有关更改和更新的详细列表，请参阅CHANGELOG.md 。

TeamRetro MCP Server