Azure DevOps MCP Server for Cline

Cline 向け Azure DevOps MCP Server

この Model Context Protocol（MCP）サーバーは Azure DevOps と連携し、Cline から Azure DevOps のサービスを操作できるようにします。

前提条件

• Node.js（v20 LTS 以上）
• npm（Node.js に付属）
• Cline のインストール
• アクセストークンを利用できる Azure DevOps アカウント

インストール

手動インストール

1. このリポジトリをクローンします。

git clone https://github.com/MananShahTR/azure-devops-mcp-server.git
cd azure-devops-mcp-server

2. 依存関係をインストールします。

npm install

3. サーバーをビルドします。

npm run build

注：ビルド出力（build/ ディレクトリ）はバージョン管理に含まれていません。リポジトリをクローンした後、ビルドコマンドを実行する必要があります。

設定

1. Azure DevOps の個人用アクセストークン（PAT）を取得する

1. Azure DevOps にアクセスしてサインインします
2. 右上のプロフィール画像をクリックします
3. 「Security」を選択します
4. 「New Token」をクリックします
5. トークンに名前を付け、必要なスコープを選択します。
   • Code (read, write) - プルリクエストの操作用
   • Work Items (read, write) - 作業項目の管理用
   • Build (read, execute) - パイプラインの操作用
   • Wiki (read, write) - Wiki の操作用
   • Project and Team (read) - プロジェクトとボードの情報用
6. 生成されたトークンをコピーします

2. Cline MCP の設定

サーバーの設定を Cline MCP の設定ファイルに追加します。

• VSCode 拡張機能の場合：%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Claude デスクトップアプリの場合：%LOCALAPPDATA%/Claude/claude_desktop_config.json

次の設定を mcpServers オブジェクトに追加します。

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-server/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_PROJECT": "your-project-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

次の値を置き換えます。

• /absolute/path/to/azure-devops-server：このリポジトリをクローンした場所の絶対パス
• your-organization：Azure DevOps の組織名
• your-project-name：Azure DevOps のプロジェクト名
• your-personal-access-token：手順 1 で生成した PAT

利用可能なツール

作業項目

• get_work_item：ID で作業項目を取得します
• list_work_items：WIQL を使用して作業項目を検索します
• create_work_item：新しい作業項目（Bug、Task、User Story）を作成します
• update_work_item：既存の作業項目を更新します

ボード

• get_boards：プロジェクトで利用可能なボードを取得します

パイプライン

• list_pipelines：プロジェクト内のすべてのパイプラインを一覧表示します
• trigger_pipeline：パイプラインを実行します

プルリクエスト

• list_pull_requests：プルリクエストを一覧表示します
• create_pull_request：新しいプルリクエストを作成します
• update_pull_request：プルリクエストを更新します
• get_pull_request：プルリクエストの詳細を取得します

Wiki

• get_wikis：プロジェクト内のすべての Wiki を一覧表示します
• get_wiki_page：Wiki ページを取得します
• create_wiki：新しい Wiki を作成します
• update_wiki_page：Wiki ページを作成または更新します

プロジェクト

• list_projects：Azure DevOps 組織内のすべてのプロジェクトを一覧表示します

確認

1. 設定を追加した後、Cline（または VSCode）を再起動します
2. Azure DevOps MCP サーバーが Cline の機能一覧に表示されます
3. MCP Inspector を使ってインストールを確認できます。

npm run inspector

トラブルシューティング

1. サーバーに接続できない場合：

   • MCP の設定にあるパスが正しいことを確認します
   • Azure DevOps の認証情報を確認します
   • Cline のログにエラーメッセージがないか確認します

2. 認証エラーが発生する場合：

   • PAT の有効期限が切れていないことを確認します
   • PAT に必要なすべてのスコープが設定されていることを確認します
   • 組織名とプロジェクト名を再確認します

3. その他の問題について：

   • Inspector ツールを実行して、サーバーが正しく動作していることを確認します
   • サーバーのログにエラーメッセージがないか確認します

開発

サーバーを変更または拡張するには：

1. src ディレクトリ内で変更を加えます
2. 開発中は npm run watch を実行します
3. 準備ができたら npm run build でビルドします
4. Inspector を使用してテストします：npm run inspector

ライセンス

MIT License - 詳細は LICENSE を参照してください