Azure DevOps MCP Server

🚀 Azure DevOps MCP 服務器

該項目實現了 Azure DevOps 的模型上下文協議 (MCP) 服務器，允許 AI 助手藉助標準化協議與 Azure DevOps API 進行交互，為 AI 與 Azure DevOps 資源的安全訪問和管理提供了便利。

🚀 快速開始

初始化服務器

from mcp_server import Server

# 初始化基本服務器
server = Server()

註冊工具

註冊自定義工具到服務器：

class MyCustomTool:
    def execute(self, params):
        # 實現具體的工具邏輯
        pass

server.register_tool("my_custom_tool", MyCustomTool())

啟動服務器

啟動 MCP 服務器並開始監聽請求：

if __name__ == "__main__":
    server.start()

✨ 主要特性

該服務器實現了 模型上下文協議 (MCP) 對於 Azure DevOps，使 AI 助手（如 Claude）能夠安全地訪問和管理 Azure DevOps 資源。該服務器作為 AI 模型與 Azure DevOps API 之間的橋樑，提供一種標準方式：

• 訪問和管理項目、工作項、倉庫等
• 創建和更新工作項、分支和拉取請求
• 通過自然語言執行常見的 DevOps 工作流
• 通過標準化資源 URI 訪問倉庫內容
• 安全地認證並交互使用 Azure DevOps 資源

📦 安裝指南

使用 pip 安裝

pip install mcp-server-azure-devops

克隆倉庫並安裝

git clone https://github.com/yourusername/mcp-server-azure-devops.git
cd mcp-server-azure-devops
python setup.py install

💻 使用示例

基礎用法

# 初始化服務器
from mcp_server import Server
server = Server()

# 註冊工具
class MyCustomTool:
    def execute(self, params):
        pass
server.register_tool("my_custom_tool", MyCustomTool())

# 啟動服務器
if __name__ == "__main__":
    server.start()

高級用法

# 自定義日誌記錄
server.set_logger(level="debug")

# 擴展功能
from mcp_server import Server, Memory, Brain
class MyExtension:
    def __init__(self):
        self._memory = None

    @property
    def memory(self):
        return self._memory

server = Server()
server.register_extension("my_extension", MyExtension())

🔧 技術細節

該服務器圍繞模型上下文協議 (MCP) 進行構建，用於與 AI 模型交互。主要包括以下組件：

核心組件

• BaseServer: 提供基礎的服務器功能，如工具註冊和日誌記錄。
• Brain: 負責理解和處理傳入的請求，並生成相應的響應。
• Memory: 管理與交互相關的上下文信息。

功能模塊

• 認證模塊:

  • authenticators: 支持多種身份驗證方法，如基於令牌和 OAuth。
  • identity_resolvers: 將用戶標識解析為具體的身份信息。

• 工具模塊

  • 提供與 Azure DevOps 資源交互的工具，包括項目管理、代碼倉庫操作等。

📚 詳細文檔

完整的 API 文檔和工具實現細節請參考 官方文檔。

🤝 貢獻

歡迎貢獻！請查看 CONTRIBUTING.md 獲取貢獻指南。

📄 許可證

MIT