teamcity-mcp

itcaat/teamcity-mcp

3.3

If you are the rightful owner of teamcity-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The TeamCity MCP Server is a comprehensive Model Context Protocol server that integrates JetBrains TeamCity with AI-ready resources and tools for LLM agents and IDE plugins.

The TeamCity MCP Server is designed to expose JetBrains TeamCity as structured resources and tools that are AI-ready, facilitating seamless integration with AI-powered IDEs and plugins. It provides a robust interface for managing and interacting with TeamCity resources through the Model Context Protocol (MCP), which is compliant with JSON-RPC 2.0 over HTTP/WebSocket. This server allows developers to automate and streamline their CI/CD processes by providing access to TeamCity's projects, build types, builds, agents, and artifacts. It supports advanced build operations such as triggering, canceling, and pinning builds, as well as setting tags and downloading artifacts. The server is production-ready, offering features like Docker and Kubernetes deployment, monitoring, caching, and comprehensive logging. Configuration is environment-based, eliminating the need for config files, and it supports both HTTP and stdio transport modes.

Features

  • MCP Protocol Compliance: Full JSON-RPC 2.0 over HTTP/WebSocket support.
  • TeamCity Integration: Complete REST API integration with authentication.
  • Resource Access: Projects, build types, builds, agents, and artifacts.
  • Build Operations: Trigger, cancel, pin builds, set tags, download artifacts, search builds.
  • Production Ready: Docker, Kubernetes, monitoring, caching, and comprehensive logging.

Usages

usage with cursor

{
  "mcpServers": {
      "teamcity": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "-e",
          "TC_URL",
          "-e",
          "TC_TOKEN",
          "itcaat/teamcity-mcp:latest",
          "--transport",
          "stdio"
        ],
        "env": {
          "TC_URL": "https://your-teamcity-server.com",
          "TC_TOKEN": "your-teamcity-api-token"
        }
      }
    }
}

local binary configuration

{
  "teamcity": {
    "command": "/path/to/teamcity-mcp",
    "args": ["--transport", "stdio"],
    "env": {
      "TC_URL": "https://your-teamcity-server.com",
      "TC_TOKEN": "your-teamcity-api-token"
    }
  }
}

Tools

  1. trigger_build

    Trigger a new build in TeamCity.

  2. cancel_build

    Cancel a running build.

  3. pin_build

    Pin or unpin a build to prevent it from being cleaned up.

  4. set_build_tag

    Add or remove tags from a build.

  5. download_artifact

    Download build artifacts.

  6. search_builds

    Search for builds with comprehensive filtering options.