CircleCI MCP Server

Model Context Protocol (MCP)的专用服务器实现，设计用于集成CircleCI的开发工作流。该项目作为CircleCI基础设施与Model Context Protocol之间的桥梁，支持增强的AI驱动开发体验。

什么是MCP服务器？

MCP信息

镜像构建信息

可用工具（12个）

工具详情

工具：analyze_diff

该工具用于根据cursor规则分析git diff（未暂存、已暂存或所有更改），以识别规则违规。默认情况下，工具将使用已暂存的更改，除非用户明确要求未暂存或所有更改。

参数：

• params: 包含以下内容的对象：
  • speedMode: boolean - 可启用的加速分析模式。默认值为false。
  • filterBy: 枚举 - "Violations" | "Compliants" | "Human Review Required" | "None" - 可应用的分析焦点过滤器。默认值为None。
  • diff: string - git diff字符串。
  • rules: string - 分析使用的规则，位于.cursorrules或.cursor/rules目录中。通过使用---分隔多个文件中的所有规则进行合并。

返回：

• git diff中发现的规则违规列表。

工具：config_helper

该工具帮助分析、验证和修复CircleCI配置文件。

参数：

• params: 包含以下内容的对象：
  • configFile: string - CircleCI配置文件的完整内容字符串。应为原始YAML内容，而非文件路径。

示例用法：

json
{
  "params": {
    "configFile": "version: 2.1\norbs:\n  node: circleci/node@7\n..."
  }
}

注意：configFile内容应作为正确转义的字符串提供，其中换行符表示为\n。

工具输出说明：

• 如果配置无效，工具将返回错误和原始配置。使用错误修复配置。
• 如果配置有效，则不执行任何操作。

工具：create_prompt_template

关于此工具：

• 该工具是生成和提供提示模板测试用例的工具链的一部分。
• 该工具帮助AI助手基于以下之一生成提示模板：
  1. 用户定义的功能需求 - 工具将基于功能需求生成新的提示模板。
  2. 用户想要测试、评估或修改的现有提示或提示模板 - 工具将其转换为更结构化和可测试的提示模板，同时保持原始提示语言相对不变。
• 该工具将返回结构化的提示模板（例如template）以及定义提示模板预期输入参数的上下文模式（例如contextSchema）。
• 在某些情况下，用户可能希望为给定应用程序中的所有提示添加测试覆盖。在这些情况下，AI代理应使用此工具为应用程序中的每个提示生成提示模板，并检查./prompts目录中未被现有提示模板覆盖的所有AI提示。

何时应触发此工具？

• 当用户提供新AI应用程序或现有应用程序新AI功能的需求时（即需要向LLM或任何AI模型发送提示请求的功能），应触发此工具。
• 当用户提供其代码库中想要测试、评估或修改的现有提示或提示模板时，也应触发此工具。
• 即使./prompts目录中存在遵循<相关名称>.prompt.yml约定的现有文件（例如bedtime-story-generator.prompt.yml、plant-care-assistant.prompt.yml、customer-support-chatbot.prompt.yml等），也应触发此工具。AI代理绝不应直接生成类似文件。相反，AI代理应首先使用此工具生成新的提示模板。

参数：

• params: 对象
  • prompt: string（用于生成提示模板的功能需求或现有提示/提示模板。可以是多行字符串。）
  • promptOrigin: "codebase" | "requirements"（指示提示来自现有代码库还是新需求）
  • model: string（提示模板将测试的模型。如果可从代码库推断，明确指定模型。否则，默认为gpt-4.1-mini。）
  • temperature: number（提示模板的温度。如果可从代码库推断，明确指定温度。否则，默认为1。）

示例用法（来自新需求）：

json
{
  "params": {
    "prompt": "创建一个应用程序，接受任何主题和年龄（以年为单位），然后为该年龄的人生成1分钟的睡前故事。",
    "promptOrigin": "requirements",
    "model": "gpt-4.1-mini",
    "temperature": 1.0
  }
}

示例用法（来自代码库中的现有提示/提示模板）：

json
{
  "params": {
    "prompt": "用户想要一个关于{{topic}}的睡前故事，适合{{age}}岁的人。请创作一个引人入胜的故事，激发他们的想象力，提供愉快的睡前体验。",
    "promptOrigin": "codebase",
    "model": "claude-3-5-sonnet-latest",
    "temperature": 0.7
  }
}

工具输出说明：

• 工具将返回...
  • template：将用户提示重新格式化为更结构化的格式。
  • contextSchema：定义模板预期输入参数的上下文模式。
  • promptOrigin：指示提示来自用户代码库中的现有提示/提示模板还是新需求。
• 工具输出（template、contextSchema和promptOrigin）还将用作recommend_prompt_template_tests工具的输入，以生成可用于测试提示模板的推荐测试列表。

工具：find_flaky_tests

该工具检索CircleCI项目中的不稳定测试信息。

接收此输出的代理必须分析不稳定测试数据，并基于识别的具体问题实施适当的修复。

关键要求：

1. 截断处理（最高优先级）：
   • 始终检查输出中是否有<MCPTruncationWarning>
   • 当存在时，必须以以下内容开始响应： "警告：日志已被截断。仅显示最新条目。可能无法查看早期构建失败。"
   • 确认截断后再进行日志分析

输入选项（必须使用以下三个选项中的一个）：

选项1 - 项目标识符（Project Slug）：

• projectSlug: 从listFollowedProjects工具获取的项目标识符（例如，"gh/organization/project"）

选项2 - 直接URL（提供以下之一）：

• projectURL: CircleCI项目的URL，格式如下：
  • 项目URL: [***]
  • 流水线URL: [***]
  • 工作流URL: [***]
  • 作业URL: [***]

选项3 - 项目检测（必须同时提供以下所有内容）：

• workspaceRoot: 工作区根目录的绝对路径
• gitRemoteURL: git远程仓库的URL

附加要求：

• 切勿使用不完整的参数调用此工具
• 如果使用选项1，确保准确提取listFollowedProjects提供的projectSlug
• 如果使用选项2，URL必须由用户提供 - 不要尝试构造或猜测URL
• 如果使用选项3，必须同时提供两个参数（workspaceRoot、gitRemoteURL）
• 如果无法完全满足任何选项，在调用工具前询问用户缺失的信息

工具：get_build_failure_logs

该工具通过检索失败日志帮助调试CircleCI构建失败。

关键要求：

1. 截断处理（最高优先级）：
   • 始终检查输出中是否有<MCPTruncationWarning>
   • 当存在时，必须以以下内容开始响应： "警告：日志已被截断。仅显示最新条目。可能无法查看早期构建失败。"
   • 确认截断后再进行日志分析

输入选项（必须使用以下三个选项中的一个）：

选项1 - 项目标识符和分支（均需提供）：

• projectSlug: 从listFollowedProjects工具获取的项目标识符（例如，"gh/organization/project"）
• branch: 分支名称（使用projectSlug时必需）

选项2 - 直接URL（提供以下之一）：

• projectURL: CircleCI项目的URL，格式如下：
  • 项目URL: [***]
  • 流水线URL: [***]
  • 旧版作业URL: [***]
  • 工作流URL: [***]
  • 作业URL: [***]

选项3 - 项目检测（必须同时提供以下所有内容）：

• workspaceRoot: 工作区根目录的绝对路径
• gitRemoteURL: git远程仓库的URL
• branch: 当前分支名称

推荐工作流：

1. 使用listFollowedProjects工具获取项目列表
2. 从所选项目中提取projectSlug（格式："gh/organization/project"）
3. 将该projectSlug与分支名称一起用于此工具

附加要求：

• 切勿使用不完整的参数调用此工具
• 如果使用选项1，确保准确提取listFollowedProjects提供的projectSlug
• 如果使用选项2，URL必须由用户提供 - 不要尝试构造或猜测URL
• 如果使用选项3，必须同时提供三个参数（workspaceRoot、gitRemoteURL、branch）
• 如果无法完全满足任何选项，在调用工具前询问用户缺失的信息

工具：get_job_test_results

该工具检索CircleCI作业的测试元数据。

优先级用例：

• 当被问及"CI中的测试是否通过？"或类似测试状态问题时
• 当被要求"修复CI中失败的测试"或帮助解决CI测试失败时
• 使用此工具检查CircleCI中的测试是否通过并识别失败的测试

常见用例：

• 获取特定作业的测试元数据
• 获取项目中所有作业的测试元数据
• 获取特定分支的测试元数据
• 获取特定流水线的测试元数据
• 获取特定工作流的测试元数据
• 获取特定作业的测试元数据

关键要求：

1. 截断处理（最高优先级）：

   • 始终检查输出中是否有<MCPTruncationWarning>
   • 当存在时，必须以以下内容开始响应： "警告：测试结果已被截断。仅显示最新条目。部分测试数据可能不可见。"
   • 确认截断后再进行测试结果分析

2. 测试结果过滤：

   • 使用filterByTestsResult参数过滤测试结果：
     • filterByTestsResult: 'failure' - 仅显示失败的测试
     • filterByTestsResult: 'success' - 仅显示成功的测试
   • 查找失败测试时，始终将filterByTestsResult设置为'failure'
   • 检查测试是否通过时，将filterByTestsResult设置为'success'

输入选项（必须使用以下三个选项中的一个）：

选项1 - 项目标识符和分支（均需提供）：

• projectSlug: 从listFollowedProjects工具获取的项目标识符（例如，"gh/organization/project"）
• branch: 分支名称（使用projectSlug时必需）

选项2 - 直接URL（提供以下之一）：

• projectURL: CircleCI作业的URL，格式如下：
  • 作业URL: [***]
  • 工作流URL: [***]
  • 流水线URL: [***]

选项3 - 项目检测（必须同时提供以下所有内容）：

• workspaceRoot: 工作区根目录的绝对路径
• gitRemoteURL: git远程仓库的URL
• branch: 当前分支名称

对于简单的测试状态检查（例如，"CI中的测试是否通过？"）或修复失败测试，如有可用的最新流水线URL，优先使用选项1。

附加要求：

• 切勿使用不完整的参数调用此工具
• 如果使用选项1，确保准确提取listFollowedProjects提供的projectSlug并包含branch参数
• 如果使用选项2，URL必须由用户提供 - 不要尝试构造或猜测URL
• 如果使用选项3，必须同时提供三个参数（workspaceRoot、gitRemoteURL、branch）
• 如果无法完全满足任何选项，在调用工具前询问用户缺失的信息

工具：get_latest_pipeline_status

该工具检索CircleCI项目最新流水线的状态。可用于检查流水线状态、获取最新构建状态或查看当前流水线状态。

常见用例：

• 检查最新流水线状态
• 获取当前构建状态
• 查看流水线状态
• 检查构建进度
• 获取流水线信息

输入选项（必须使用以下三个选项中的一个）：

选项1 - 项目标识符和分支（均需提供）：

• projectSlug: 从listFollowedProjects工具获取的项目标识符（例如，"gh/organization/project"）
• branch: 分支名称（使用projectSlug时必需）

选项2 - 直接URL（提供以下之一）：

• projectURL: CircleCI项目的URL，格式如下：
  • 项目URL: [***]
  • 流水线URL: [***]
  • 工作流URL: [***]