Azure Devops MCP Server

🚀 Azure DevOps MCP サーバー

自然言語を通じて、Azure DevOps とより簡単にやり取りできます。

これは TypeScript ベースの MCP サーバーで、axios を使用して Azure DevOps REST API を呼び出し、Azure DevOps のワークアイテムを管理します。

✨ 主な機能

ツール

このサーバーは、Azure DevOps リソースを管理するための以下のツールを提供しています。

• create_work_item: Azure DevOps で新しいワークアイテム（ユーザーストーリー、バグ、タスクなど）を作成します。

  • 必須パラメーター: type (タイプ), title (タイトル)。
  • オプションパラメーター: projectName (プロジェクト名、デフォルトは現在のプロジェクト)、description (説明)、severity (重大度)、priority (優先度)、state (状態)、assignee (担当者)、tags (タグリスト)。

• query_work_items: Azure DevOps プロジェクト内のワークアイテムをクエリします。

  • 必須パラメーター: projectName (プロジェクト名、デフォルトは現在のプロジェクト)、query (クエリ条件、Azure Query Language をサポート)。
  • 戻り値: 一致するワークアイテムのリスト。

• update_work_item: 既存のワークアイテムの属性を更新します。

  • 必須パラメーター: id (ワークアイテム ID)、fields (更新するフィールドとその値)。

• delete_work_item: 指定されたワークアイテムを削除します。

  • 必須パラメーター: id (ワークアイテム ID)。

📦 インストール

この MCP サーバーを使用するには、以下の手順でインストールしてください。

1. コードリポジトリをクローンします。

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

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

   npm install
   

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

   npm run build
   

4. （オプション）開発環境を自動再構築するように設定します。

   npm run watch
   

📚 ドキュメント

Claude Desktop でこの MCP サーバーを使用するには、以下の手順で設定してください。

Windows システム

• %APPDATA%/Claude/claude_desktop_config.json ファイルを開きます。
• mcpServers ノードの下に以下の内容を追加します。

  {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 例: https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• YOUR_ORG_URL を自分の Azure DevOps 組織の URL に、YOUR_PERSONAL_ACCESS_TOKEN を自分の個人アクセストークンに置き換えます。

MacOS システム

• ~/Library/Application Support/Claude/claude_desktop_config.json ファイルを開きます。
• mcpServers ノードの下に以下の内容を追加します。

  {
    "azure-devops-mcp-server": {
      "command": "/usr/local/bin/node",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 例: https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• YOUR_ORG_URL を自分の Azure DevOps 組織の URL に、YOUR_PERSONAL_ACCESS_TOKEN を自分の個人アクセストークンに置き換えます。

🔧 技術詳細

MCP サーバーは標準入出力を介して通信するため、デバッグは難しい場合があります。MCP インスペクター の使用をおすすめします。これはパッケージスクリプトとして提供されるツールです。

npm run inspector

インスペクターは、ブラウザーでデバッグツールの URL を提供します。

📖 参考資料

• Azure DevOps REST API リファレンスドキュメント