MCP 服务器

Bitrise MCP Server

用于 Bitrise API 的 MCP 服务器，支持应用管理、构建操作、构件管理等功能。

bitrise-io

开发者工具

访问服务器

README

Bitrise MCP 服务器

Bitrise API 的 MCP 服务器，支持应用管理、构建操作、工件管理等。

功能

全面的 API 访问: 访问 Bitrise API，包括应用、构建、工件等。
身份验证支持: 基于安全 API 令牌访问 Bitrise 资源。
详细的文档: 具有参数描述的完善文档的工具。

设置

环境设置

需要 Python 3.12.6 (可以使用 pyenv)。
使用 uv 进行依赖管理。

环境设置示例

请阅读 uv 和 pylint 的官方文档以获取更多选项。

# 安装 pyenv 和 python 3.12.6
curl -fsSL https://pyenv.run | bash
pyenv install 3.12.6

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

Bitrise API 令牌

创建一个 Bitrise API 令牌:

转到您的 Bitrise 帐户设置/安全。
导航到“个人访问令牌”部分。
复制生成的令牌。

与 Claude Desktop 一起使用

本指南使用 Claude Desktop 作为 MCP 客户端，但您可以使用任何其他 MCP 兼容的客户端，并根据您的首选客户端调整以下配置选项。

打开 Claude 设置，然后导航到“开发者”选项卡。

单击“编辑配置”。这将创建一个名为 claude_desktop_config.json 的配置文件。使用您喜欢的编辑器打开此文件，并添加 Bitrise MCP 服务器：

{
  "mcpServers": {
    "bitrise": {
      "command": "uvx",
      "env": {
        "BITRISE_TOKEN": "<YOUR_TOKEN>"
      },
      "args": [
        "--from",
        "git+https://github.com/bitrise-io/bitrise-mcp@v1.0.0",
        "bitrise-mcp"
      ]
    }
  }
}

保存配置文件并重新启动 Claude Desktop。如果一切设置正确，您应该会在消息编辑器旁边看到一个锤子图标。

您可以限制暴露给 MCP 客户端的工具数量。如果您想优化令牌使用量，或者您的 MCP 客户端对工具数量有限制，这将非常有用。

工具按其“API 组”分组，您可以将要公开的组作为工具传递。可能的值：apps, builds, workspaces, webhooks, build-artifacts, group-roles, cache-items, pipelines, account, read-only。

配置示例：

{
  "mcpServers": {
    "bitrise": {
      "command": "<ABSOLUTE_PATH_TO>/uvx",
      "env": {
        "BITRISE_TOKEN": "<YOUR_PAT>"
      },
      "args": [
        "--from",
        "git+https://github.com/bitrise-io/bitrise-mcp@v1.0.0",
        "bitrise-mcp",
        "--enabled-api-groups",
        "cache-items,pipelines"
      ]
    }
  }
}

工具

应用

list_apps
- 列出经过身份验证的帐户可用的所有应用
- 参数：
  - sort_by (可选): 应用的排序方式：last_build_at (默认) 或 created_at
  - next (可选): 响应中第一个应用的 slug
  - limit (可选): 每页的最大元素数 (默认: 50)
register_app
- 向 Bitrise 添加一个新应用
- 参数：
  - repo_url: 仓库 URL
  - is_public: 应用的构建可见性是否为“公开”
  - organization_slug: 要将应用添加到的组织（又名工作区）
  - project_type (可选): 项目类型 (ios, android, 等)
  - provider (可选): github
finish_bitrise_app
- 完成 Bitrise 应用的设置
- 参数：
  - app_slug: 要完成设置的 Bitrise 应用的 slug
  - project_type (可选): 项目类型 (例如，android, ios, flutter, 等)
  - stack_id (可选): 用于应用的堆栈 ID
  - mode (可选): 设置模式
  - config (可选): 用于应用的配置
get_app
- 获取特定应用的详细信息
- 参数：
  - app_slug: Bitrise 应用的标识符
delete_app
- 从 Bitrise 删除一个应用
- 参数：
  - app_slug: Bitrise 应用的标识符
update_app
- 更新一个应用
- 参数：
  - app_slug: Bitrise 应用的标识符
  - is_public: 应用的构建可见性是否为“公开”
  - project_type: 项目类型
  - provider: 仓库提供商
  - repo_url: 仓库 URL
get_bitrise_yml
- 获取指定 Bitrise 应用的当前 Bitrise YML 配置文件
- 参数：
  - app_slug: Bitrise 应用的标识符
update_bitrise_yml
- 更新指定 Bitrise 应用的 Bitrise YML 配置文件
- 参数：
  - app_slug: Bitrise 应用的标识符
  - bitrise_yml_as_json: 新的 Bitrise YML 配置文件内容
list_branches
- 列出应用的仓库中具有现有构建的分支
- 参数：
  - app_slug: Bitrise 应用的标识符
register_ssh_key
- 向特定应用添加 SSH 密钥
- 参数：
  - app_slug: Bitrise 应用的标识符
  - auth_ssh_private_key: 私有 SSH 密钥
  - auth_ssh_public_key: 公共 SSH 密钥
  - is_register_key_into_provider_service: 在提供商服务中注册密钥
register_webhook
- 为特定应用程序注册传入的 webhook
- 参数：
  - app_slug: Bitrise 应用的标识符

构建

list_builds
- 列出指定 Bitrise 应用的所有构建或所有可访问的构建
- 参数：
  - app_slug (可选): Bitrise 应用的标识符
  - sort_by (可选): 构建的排序方式：created_at (默认), running_first
  - branch (可选): 按分支过滤构建
  - workflow (可选): 按工作流过滤构建
  - status (可选): 按状态过滤构建 (0: 未完成, 1: 成功, 2: 失败, 3: 中止, 4: 进行中)
  - next (可选): 响应中第一个构建的 slug
  - limit (可选): 每页的最大元素数 (默认: 50)
trigger_bitrise_build
- 为指定的 Bitrise 应用触发新的构建/流水线
- 参数：
  - app_slug: Bitrise 应用的标识符
  - branch (可选): 要构建的分支 (默认: main)
  - workflow_id (可选): 要构建的工作流
  - commit_message (可选): 构建的提交消息
  - commit_hash (可选): 构建的提交哈希
get_build
- 获取给定应用的特定构建
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
abort_build
- 中止特定构建
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
  - reason (可选): 中止构建的原因
get_build_log
- 获取 Bitrise 应用的指定构建的构建日志
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: Bitrise 构建的标识符
get_build_bitrise_yml
- 获取构建的 bitrise.yml
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
list_build_workflows
- 列出应用的工作流
- 参数：
  - app_slug: Bitrise 应用的标识符

构建工件

list_artifacts
- 获取所有构建工件的列表
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
  - next (可选): 响应中第一个工件的 slug
  - limit (可选): 每页的最大元素数 (默认: 50)
get_artifact
- 获取特定的构建工件
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
  - artifact_slug: 工件的标识符
delete_artifact
- 删除构建工件
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
  - artifact_slug: 工件的标识符
update_artifact
- 更新构建工件
- 参数：
  - app_slug: Bitrise 应用的标识符
  - build_slug: 构建的标识符
  - artifact_slug: 工件的标识符
  - is_public_page_enabled: 启用工件的公共页面

Webhooks

list_outgoing_webhooks
- 列出应用的传出 webhook
- 参数：
  - app_slug: Bitrise 应用的标识符
delete_outgoing_webhook
- 删除应用的传出 webhook
- 参数：
  - app_slug: Bitrise 应用的标识符
  - webhook_slug: webhook 的标识符
update_outgoing_webhook
- 更新应用的传出 webhook
- 参数：
  - app_slug: Bitrise 应用的标识符
  - webhook_slug: webhook 的标识符
  - events: 触发 webhook 的事件列表
  - url: webhook 的 URL
  - headers (可选): 与 webhook 一起发送的标头
create_outgoing_webhook
- 为应用创建一个传出 webhook
- 参数：
  - app_slug: Bitrise 应用的标识符
  - events: 触发 webhook 的事件列表
  - url: webhook 的 URL
  - headers (可选): 与 webhook 一起发送的标头

缓存项

list_cache_items
- 列出属于应用程序的键值缓存项
- 参数：
  - app_slug: Bitrise 应用的标识符
delete_all_cache_items
- 删除属于应用程序的所有键值缓存项
- 参数：
  - app_slug: Bitrise 应用的标识符
delete_cache_item
- 删除键值缓存项
- 参数：
  - app_slug: Bitrise 应用的标识符
  - cache_item_id: 缓存项的标识符
get_cache_item_download_url
- 获取键值缓存项的下载 URL
- 参数：
  - app_slug: Bitrise 应用的标识符
  - cache_item_id: 缓存项的标识符

流水线

list_pipelines
- 列出应用程序的所有流水线和独立构建
- 参数：
  - app_slug: Bitrise 应用的标识符
get_pipeline
- 获取给定应用程序的流水线
- 参数：
  - app_slug: Bitrise 应用的标识符
  - pipeline_id: 流水线的标识符
abort_pipeline
- 中止流水线
- 参数：
  - app_slug: Bitrise 应用的标识符
  - pipeline_id: 流水线的标识符
  - reason (可选): 中止流水线的原因
rebuild_pipeline
- 重建流水线
- 参数：
  - app_slug: Bitrise 应用的标识符
  - pipeline_id: 流水线的标识符

组角色

list_group_roles
- 列出应用程序的组角色
- 参数：
  - app_slug: Bitrise 应用的标识符
  - role_name: 角色的名称
replace_group_roles
- 替换应用程序的组角色
- 参数：
  - app_slug: Bitrise 应用的标识符
  - role_name: 角色的名称
  - group_slugs: 组 slug 的列表

工作区

list_workspaces
- 列出用户有权访问的工作区
get_workspace
- 获取一个工作区的详细信息
- 参数：
  - workspace_slug: Bitrise 工作区的 slug
get_workspace_groups
- 获取工作区中的组
- 参数：
  - workspace_slug: Bitrise 工作区的 slug
create_workspace_group
- 在工作区中创建一个组
- 参数：
  - workspace_slug: Bitrise 工作区的 slug
  - group_name: 组的名称
get_workspace_members
- 获取工作区中的成员
- 参数：
  - workspace_slug: Bitrise 工作区的 slug
invite_member_to_workspace
- 邀请成员加入工作区
- 参数：
  - workspace_slug: Bitrise 工作区的 slug
  - email: 用户的电子邮件地址
add_member_to_group
- 将成员添加到组
- 参数：
  - group_slug: 组的 slug
  - user_slug: 用户的 slug

帐户

me
- 从当前经过身份验证的用户帐户获取信息

API 组

Bitrise MCP 服务器将工具组织到 API 组中，这些组可以通过命令行参数启用或禁用。下表显示了每个工具所属的 API 组：

工具	apps	builds	workspaces	webhooks	build-artifacts	group-roles	cache-items	pipelines	account	read-only
list_apps	✅									✅
register_app	✅
finish_bitrise_app	✅
get_app	✅									✅
delete_app	✅
update_app	✅
get_bitrise_yml	✅									✅
update_bitrise_yml	✅
list_branches	✅									✅
register_ssh_key	✅
register_webhook	✅
list_builds		✅								✅
trigger_bitrise_build		✅
get_build		✅								✅
abort_build		✅
get_build_log		✅								✅
get_build_bitrise_yml		✅								✅
list_build_workflows		✅								✅
list_artifacts					✅					✅
get_artifact					✅					✅
delete_artifact					✅
update_artifact					✅
list_outgoing_webhooks				✅						✅
delete_outgoing_webhook				✅
update_outgoing_webhook				✅
create_outgoing_webhook				✅
list_cache_items							✅			✅
delete_all_cache_items							✅
delete_cache_item							✅
get_cache_item_download_url							✅			✅
list_pipelines								✅		✅
get_pipeline								✅		✅
abort_pipeline								✅
rebuild_pipeline								✅
list_group_roles						✅				✅
replace_group_roles						✅
list_workspaces			✅							✅
get_workspace			✅							✅
get_workspace_groups			✅							✅
create_workspace_group			✅
get_workspace_members			✅							✅
invite_member_to_workspace			✅
add_member_to_group			✅
me									✅	✅

默认情况下，所有 API 组都已启用。您可以使用 --enabled-api-groups 命令行参数指定要启用的组，并使用逗号分隔的组名称列表。