drone-ci-mcp

drone-ci-mcp

drone.io の CI ビルド情報とログを MCP として公開する、独自の方針に基づいた MCP サーバーです。読み取り専用機能のみをサポートします。

警告

現在も開発中です。自己責任でご利用ください。

使用方法

トランスポートの起動

npx -y drone-ci-mcp --access-token=<access-token-from-drone> --server-url=<url>

Claude の設定

{
  "mcpServers": {
    "drone-ci-mcp": {
      "command": "npx",
      "args": [
        "-y"
        "drone-ci-mcp",
        "--access-token=<token>",
        "--server-url=<url>"
      ]
    }
  }
}

MCP Inspector

npx @modelcontextprotocol/inspector npx -y drone-ci-mcp --access-token=<token> --server-url=<url>

ツール

drone_build_info

ビルド情報を検索し、結果を YAML として返す読み取り専用ツールです。

入力：

1. repoSlug - drone におけるリポジトリのスラッグです。オーナー／組織名とリポジトリ名を「/」でつないだものです。例：owner/repo
2. buildNumber - drone CI のビルド番号です。

出力：

https://docs.drone.io/api/builds/build_info/ からのレスポンスを Markdown + YAML 形式で返します。

# Build **1** in **<repo slug>**

```yaml
id: 1
repo_id: 5
trigger:<trigger>
number: 1
status: success
event: custom
action: ''
link: >-
  https://github.com/<commit-link>
timestamp: 0
message: <commit message>
before: dbde12a8600cb6591f4c84085acb95d08b5505e6
after: dbde12a8600cb6591f4c84085acb95d08b5505e6
ref: refs/heads/main
source_repo: ''
source: main
target: main
author_login: <username>
author_name: <name>
author_email: <email>
author_avatar: <avatar>
sender: madappa-sharath
started: 1745806907
finished: 1745806908
created: 1745806904
updated: 1745806907
version: 3
stages:
  - id: 1
    repo_id: 5
    build_id: 1
    number: 1
    name: hello-world
    kind: pipeline
    type: docker
    status: success
    errignore: false
    exit_code: 0
    machine: drone-runner-65d8dd8798-rf8xr
    os: linux
    arch: arm64
    started: 1745806907
    stopped: 1745806908
    created: 1745806904
    updated: 1745806908
    version: 4
    on_success: true
    on_failure: false
    steps:
      - id: 1
        step_id: 1
        number: 1
        name: clone
        status: success
        exit_code: 0
        started: 1745806907
        stopped: 1745806908
        version: 4
        image: drone/git:latest
        .....
```

drone_build_info

ステップのログを検索する読み取り専用ツールです。

入力：

1. repoSlug - drone におけるリポジトリのスラッグです。オーナー／組織名とリポジトリ名を「/」でつないだものです。例：owner/repo
2. buildNumber - drone CI のビルド番号です。
3. stageNumber - ビルドステージ番号です。ステージの「number」フィールドに示されています。
4. stepId - ビルドステップ ID です。ステップの「step_id」フィールドに示されています。

出力：

https://docs.drone.io/api/builds/build_logs/ からのレスポンスを Markdown 形式で返します。

# Logs for step 2 in stage **1** of **1** build in **<repo slug>** repository

```shell
+ echo 'hello-world'
,hello-world
```

デモ