ado-mcp-server

ado-mcp-server

Azure DevOps 用の Model Context Protocol（MCP）サーバーです。

概要

このプロジェクトは、Azure DevOps との統合を目的とした MCP サーバーを実装しています。サーバーは @modelcontextprotocol/sdk を使用して構築されており、モジュール式のツール登録システムによって拡張できます。

機能

• 公式 SDK を使用した MCP サーバーの実装
• プロジェクトツールおよび作業項目ツールを登録するための拡張可能なアーキテクチャ
• Azure DevOps Work Item Tracking（WIT）REST API エンドポイントを全面的にサポート（作成、取得、更新、削除、一覧表示、クエリ、バッチ、リビジョン、コメント、添付ファイル、関連付け）
• 他のシステムとの統合に対応する STDIO 経由での実行

はじめに

前提条件

• Node.js（バージョン 16 以降を推奨）
• npm

インストール

リポジトリをクローンして、依存関係をインストールします。

git clone https://github.com/dmedellin/ado-mcp-server.git
cd ado-mcp-server
npm install

使用方法

MCP サーバーを起動します。

npm start

サーバーは STDIO 経由で実行され、互換性のあるクライアントと統合できます。

テスト

Model Context Protocol Inspector を使用して、サーバーをテストできます。

npx @modelcontextprotocol/inspector

プロジェクト構成

• index.js - エントリーポイント。MCP サーバーを初期化して実行します。
• features/ - プロジェクトツールおよび作業項目ツールを登録するディレクトリです。

スクリプト

• npm start - MCP サーバーを起動します。
• npm test - （現在は実装されていません。）

構成

基本的な使用に追加の構成は必要ありません。features ディレクトリに新しいツールを追加して、機能を拡張できます。

依存関係

• @modelcontextprotocol/sdk
• zod

ライセンス

ISC

---

このプロジェクトは Microsoft または Azure DevOps とは提携していません。

ツール

• linkWorkItems — 2 つの Azure DevOps 作業項目をリンクします（例：親子、関連など）。

  • 入力：
    • sourceId（number/string）：ソース作業項目の ID（例：親子リンクにおける子）。
    • targetId（number/string）：対象作業項目の ID（例：親子リンクにおける親）。
    • linkType（string、任意）：リンクの種類（親子の場合、デフォルトは System.LinkTypes.Hierarchy-Forward）。
    • comment（string、任意）：リンク操作に付ける任意のコメント。
  • 権限： Azure DevOps プロジェクトで作業項目を編集する権限が必要です。
  • 例：

    {
      "sourceId": 123,
      "targetId": 456,
      "linkType": "System.LinkTypes.Hierarchy-Forward"
    }
    

• unlinkWorkItems — 2 つの Azure DevOps 作業項目間のリンク（例：親子、関連）を削除します。

  • 入力：
    • sourceId（number/string）：ソース作業項目の ID（リンクを保持している項目）。
    • targetId（number/string）：対象作業項目の ID（リンク先の項目）。
    • linkType（string、任意）：削除するリンクの種類（親子の場合、デフォルトは System.LinkTypes.Hierarchy-Forward）。
  • 権限： Azure DevOps プロジェクトで作業項目を編集する権限が必要です。
  • 例：

    {
      "sourceId": 123,
      "targetId": 456,
      "linkType": "System.LinkTypes.Hierarchy-Forward"
    }
    

• その他のリンクの種類については、Azure DevOps のドキュメントを参照してください。