Farzad528 MCP Server Azure Ai Agents

🚀 Azure AI代理服務 + Azure AI搜索MCP服務器

本項目是一個模型上下文協議（MCP）服務器，能讓Claude Desktop藉助Azure AI服務開展內容搜索。您可以選擇使用Azure AI Agent Service（涵蓋文檔搜索與網絡搜索），也能直接集成Azure AI搜索。

🚀 快速開始

此項目提供了兩種MCP服務器實現，用於將Claude Desktop與Azure搜索功能連接。您可根據自身需求選擇合適的實現方式，開啟Claude Desktop與Azure搜索的連接之旅。

✨ 主要特性

• 支持多種搜索模式：基於索引、網絡和混合
• 可配置的工具指令以調整搜索行為
• 靈活的響應格式化選項
• 擴展性強，可輕鬆添加新功能
• 中文與英文雙語支持

📦 安裝指南

1. 安裝Python環境

確保已安裝Python 3.8或更高版本，並安裝pip。

python --version
pip install --upgrade pip

2. 安裝依賴項

對於Azure AI Agent Service：

uv pip install "mcp[cli]" azure-core==1.5.0 python-dotenv

對於直接Azure AI搜索：

uv pip install "mcp[cli]" azure-search-documents==11.5.2 python-dotenv

3. 下載項目代碼

從GitHub克隆倉庫：

git clone https://github.com/your-organization/azure-ai-mcp.git
cd azure-ai-mcp

📚 詳細文檔

配置說明

Azure AI Agent Service配置

創建一個env_agent_service文件，添加以下內容並替換為您的實際信息：

AZURE_AI_SUBSCRIPTION_ID=your-subscription-id
AZURE_AI_ENDPOINT=https://your-region.api.cognitive.microsoft.com

直接Azure AI搜索配置

創建一個env_search_service文件，添加以下內容並替換為您的實際信息：

AZURE_SEARCH_SERVICE_ENDPOINT=https://your-service-name.search.windows.net
AZURE_SEARCH_INDEX_NAME=your-index-name
AZURE_SEARCH_API_KEY=your-api-key

使用方法

啟動服務器

對於Azure AI Agent Service：

uv run python server.py

對於直接Azure AI搜索：

uv run python search_server.py

在Claude Desktop中配置

Azure AI Agent Service配置：

{
  "mcpServers": {
    "azure-agent-service": {
      "command": "C:\\路徑\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路徑\\to\\server.py"],
      "env": {
        "AZURE_AI_SUBSCRIPTION_ID": "your-subscription-id",
        "AZURE_AI_ENDPOINT": "https://your-region.api.cognitive.microsoft.com"
      }
    }
  }
}

直接Azure AI搜索配置：

{
  "mcpServers": {
    "azure-search-service": {
      "command": "C:\\路徑\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路徑\\to\\search_server.py"],
      "env": {
        "AZURE_SEARCH_SERVICE_ENDPOINT": "https://your-service-name.search.windows.net",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name",
        "AZURE_SEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

示例用法

在Claude Desktop中輸入以下查詢：

• 使用Azure AI搜索工具：
  • "搜索我的Azure索引中的AI相關信息"
• 使用必應網絡定位工具：
  • "在網絡上查找大語言模型的最新發展"
• 使用混合搜索工具：
  • "查找關於深度學習的研究論文"

常見問題

服務器未顯示

1. 檢查Claude Desktop日誌（位於%APPDATA%\Claude\logs\mcp*.log）
2. 確保文件路徑和環境變量配置正確
3. 測試直接運行服務器：python server.py

Azure AI Agent Service問題

1. 確保Azure AI項目正確配置
2. 驗證連接是否存在且配置正確
3. 檢查Azure認證狀態

自定義選項

• 修改工具指令 - 調整每個代理的指令以改變其處理查詢的方式
• 添加新功能 - 使用@mcp.tool()裝飾器集成更多功能
• 自定義響應格式 - 編輯Claude Desktop返回響應的方式
• 調整網絡搜索參數 - 修改必應搜索工具的關注領域

📄 許可證

此項目使用MIT許可證。