teamcity-mcp

概述

TeamCity MCP 服务器连接 AI 编码助手与 TeamCity CI/CD 服务器，将 TeamCity 操作作为 MCP 工具暴露。它提供两种操作模式：开发模式（31 个工具，用于安全的 CI/CD 操作）和完整模式（87 个工具，用于完整的基础设施管理）。该服务器支持基于令牌的身份验证，提供运行时模式切换，并采用清洁、高性能的架构，具有清晰的模块边界。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• TriggerBuild

  Queue a new build in TeamCity

  试试:Trigger a build for the frontend project试试:Start a new build with branch main
• GetBuildStatus

  Check the progress and status of a specific build

  试试:What's the status of build 12345?试试:Is build 67890 complete yet?
• FetchBuildLog

  Retrieve the logs for a specific build

  试试:Get the build log for build 12345试试:Show me the complete output from build 67890
• ListBuilds

  Search and list builds based on criteria

  试试:List all builds for the last 24 hours试试:Show me builds that failed in the last week
• ListTestFailures

  Get a list of failing tests in a build

  试试:Which tests failed in build 12345?试试:Show me all test failures from the latest build
• GetTestDetails

  Get detailed information about a specific test

  试试:Get details for test case 54321试试:Show me more information about failing test abc123
• AnalyzeBuildProblems

  Identify the root causes of build failures

  试试:Analyze why build 12345 failed试试:Investigate the problems with build 67890
• create_build_config

  Create a new TeamCity build configuration

  试试:Create a new build config for the mobile app试试:Set up a CI pipeline for the backend service
• clone_build_config

  Duplicate an existing build configuration

  试试:Clone the existing frontend config for the new branch试试:Copy the build config from project A to project B
• update_build_config

  Modify an existing build configuration

  试试:Update the build steps for config 12345试试:Change the artifact rules for the mobile build
• get_mcp_mode

  Check the current operational mode of the MCP server

  试试:What mode is the server currently running in?试试:Is the server in Full or Dev mode?
• set_mcp_mode

  Change the operational mode of the MCP server

  试试:Switch the server to Full mode试试:Set the MCP mode to Dev

可对比工具

安装

# 使用 npx 和环境变量
TEAMCITY_URL="https://teamcity.example.com" \
TEAMCITY_TOKEN="<your_token>" \
MCP_MODE=dev \
npx -y @daghis/teamcity-mcp

{
  "mcpServers": {
    "teamcity": {
      "command": "npx",
      "args": [
        "-y",
        "@daghis/teamcity-mcp",
        "--url",
        "https://teamcity.example.com",
        "--token",
        "tc_<your_token>"
      ]
    }
  }
}

FAQ

开发模式和完整模式有什么区别？

开发模式（默认）提供 31 个工具用于安全的 CI/CD 操作，而完整模式提供 87 个工具用于完整的基础设施管理，包括配置创建、代理管理和服务器管理。

如何切换模式？

您可以将 MCP_MODE 环境变量设置为 'dev' 或 'full'。使用 v2.1.0+，您还可以使用 'get_mcp_mode' 和 'set_mcp_mode' 工具在运行时切换模式，无需重启。

teamcity-mcp 对比