Azdo MCP

🚀 Azure DevOps MCP サーバー

Azure DevOps との統合を提供する MCP（モデルコンテキストプロトコル）サーバーです。これにより、AI アシスタントが Azure DevOps のワークアイテム、プルリクエスト、およびウィキページと相互作用できます。

✨ 主な機能

• ワークアイテム管理（作成、一覧表示、取得）
• プルリクエスト操作（作成、一覧表示、取得、コメント、差分表示）
• ウィキページ管理（作成、編集）

📦 インストール

インストール準備

1. 依存関係のインストール：

npm install

2. 環境変数の設定（.env ファイルを作成）：

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=あなたの個人アクセストークン
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

3. サーバーのビルド：

npm run build

サーバーの設定

サーバーの設定をあなたの MCP 設定に追加します。

VSCode の場合

macOS/Linux

以下の内容を ~/.vscode/cline_mcp_settings.json または同様のファイルに追加します：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "devMode": false
    }
  }
}

Windows

以下の内容を C:\\Users\\<YourUsername>\\.vscode\\cline_mcp_settings.json に追加します：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:\\path\\to\\azure-devops-mcp\\build\\index.js"],
      "devMode": false
    }
  }
}

💻 使用例

ワークアイテム

ワークアイテムの作成

POST /workitems
Content-Type: application/json

{
  "title": "新任务",
  "description": "这是一个新的 Azure DevOps 工作项。",
  "project": "default-project",
  "type": "task"
}

すべてのワークアイテムの取得

GET /workitems

特定のワークアイテムの取得

GET /workitems/{id}

プルリクエスト

プルリクエストの作成

POST /pullrequests
Content-Type: application/json

{
  "sourceBranch": "refs/heads/main",
  "targetBranch": "refs/heads/master",
  "title": "新的功能提交"
}

すべてのプルリクエストの取得

GET /pullrequests

特定のプルリクエストの取得

GET /pullrequests/{id}

ウィキ

ウィキページの作成

POST /wiki/defaultwiki/_/newfile
Content-Type: application/json

{
  "path": "/pages/home.md",
  "content": "## 欢迎来到我们的新维基！"
}

ウィキページの更新

PUT /wiki/defaultwiki/_/file/pages/home.md
Content-Type: application/json

{
  "content": "## 欢迎来到更新的维基！",
  "etag": "12345678-90AB-CDEF-1234-567890ABCDEF"
}

🔧 開発

開発モードで実行し、環境変数を使用するには：

npm run dev

📄 注意事項

ツールのパラメータで project と repository が明示的に指定されていない場合、環境設定で指定されたデフォルト値が使用されます。