MCP Server Azure Ai Agents

Azure AI搜索代理服務與Claude桌面集成的MCP服務器

搜索工具人工智能聊天機器人 #AI搜索 #文檔檢索 #網頁搜索 #Claude集成 .Python

評分 : 2.5分

下載量 : 55

更新時間 : 2025-04-29

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "azure-ai-agent": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\azure_ai_agent_service_server.py"],
      "env": {
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "MODEL_DEPLOYMENT_NAME": "your-model-deployment-name",
        "AI_SEARCH_CONNECTION_NAME": "your-search-connection-name",
        "BING_CONNECTION_NAME": "your-bing-connection-name",
        "AI_SEARCH_INDEX_NAME": "your-index-name"
      }
    }
  }
}

{
     "mcpServers": {
       "azure-search": {
         "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\azure_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"
         }
       }
     }
   }

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

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

本項目提供了一個模型上下文協議（MCP）服務器，可讓 Claude Desktop 藉助 Azure AI 服務搜索您的內容。您可以選擇 Azure AI Agent Service（支持文檔搜索和網絡搜索），也可以直接集成 Azure AI Search。

🚀 快速開始

此項目提供了一個 MCP 服務器，使 Claude Desktop 能夠通過 Azure AI 服務開展搜索和信息檢索工作。它支持兩種集成方式，您既可以使用具備代理功能的 Azure AI Agent Service，也能直接集成 Azure AI Search。

✨ 主要特性

文檔搜索：能夠從 Azure 搜索索引裡查找所需信息。
網絡搜索：可藉助 Azure AI Agent Service 進行網絡搜索。
混合搜索：可將文檔搜索與網絡搜索的結果相結合。
自定義工具：能通過 @mcp.tool() 裝飾器添加新的工具。

📦 安裝指南

Azure AI Agent Service 實現

步驟

創建 .env 文件，並添加如下內容：

AZURE_AI_API_KEY=your-api-key

安裝依賴項：

pip install "mcp[cli]" azure-ai-legacy-chatbots==0.4.0 python-dotenv

使用 azure_ai_agent_service_server.py 腳本啟動服務器。

Azure AI 搜索直接集成

步驟

創建 .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

安裝依賴項：

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

使用 azure_search_server.py 腳本啟動服務器。

📚 詳細文檔

快速鏈接

要求

Python：需使用 3.8 或更高版本。
Azure 帳戶：用於訪問 Azure AI 代理服務和 Azure Search。

測試服務器

重啟 Claude Desktop 以加載新配置。
在輸入字段底部右側查找 MCP 工具圖標（錘子圖標）。
嘗試以下查詢：
- "搜索我的 Azure 搜索索引中的 AI 信息"
- "在網絡上搜索最新的 LLM 發展動態"
- "使用混合搜索查找神經網絡的相關信息"

故障排除

服務器未顯示：
- 檢查 Claude Desktop 日誌（位於 %APPDATA%\Claude\logs\mcp*.log）。
- 驗證文件路徑和環境變量配置。
- 測試直接運行服務器：python azure_ai_agent_service_server.py 或 uv run python.azure_ai_agent_service_server.py
Azure AI Agent Service 問題：
- 確保 Azure AI 項目正確配置。
- 驗證連接是否存在且配置正確。
- 檢查 Azure 身份驗證狀態。