MCP Server

🚀 Azure AI Agent 服務 + Azure AI Search MCP 服務器

本項目是一個模型上下文協議 (MCP) 服務器，藉助 Azure AI 服務，讓 Claude 桌面能夠搜索你的內容。你可以選擇使用 Azure AI Agent Service（支持文檔搜索與網絡搜索），也能直接集成到 Azure AI Search。

🚀 快速開始

此項目提供了兩種 MCP 服務器實現，用於將 Claude 桌面連接到 Azure 搜索功能：

1. Azure AI Agent Service 實現（推薦） - 使用強大的 Azure AI Agent Service 提供：

   • Azure AI 搜索工具 - 在你的索引文檔中搜索並獲得增強的上下文
   • 必應網絡內容工具 - 從互聯網獲取即時信息

2. 直接集成到 Azure AI Search - 提供三種搜索模式：

   • 關鍵詞搜索 - 精確匹配搜索內容
   • 向量相似度搜索 - 基於語義相似性進行搜索
   • 混合搜索 - 結合關鍵詞和上下文理解的綜合搜索

✨ 主要特性

• 支持多語言和複雜查詢
• 提供即時網絡搜索功能
• 可擴展的工具鏈設計
• 高性能文檔檢索引擎

🔗 快速鏈接

• Azure AI Agent Service 官方文檔
• Azure AI Search 文檔
• Claude 桌面 MCP 插件開發指南

📦 安裝指南

配置要求

1. 推薦使用環境：

   • Windows 10 或更高版本
   • Python 3.8+

2. 必需依賴項：

   • Azure SDK for Python (azure-search-documents, azure-ai-agent)
   • Python 網絡請求庫 (requests)

使用 Azure AI Agent Service

1. 創建一個新的 .env 文件並添加以下內容：

AZURE_AI_AGENT_ENDPOINT=your-endpoint
AZURE_AI_AGENT_KEY=your-key
AZURE_SEARCH_SERVICE_ENDPOINT=your-search-service-endpoint
AZURE_SEARCH_API_KEY=your-search-api-key

2. 安裝依賴項：

pip install "mcp[cli]" azure-ai-agent==1.0.0 python-dotenv

3. 啟動服務器：

python azure_ai_agent_service_server.py

直接集成到 Azure AI Search

1. 創建一個新的 .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

2. 安裝依賴項：

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

3. 啟動服務器：

python azure_search_server.py

💻 使用示例

基礎用法

在 Claude 桌面中可輸入以下查詢示例：

- "搜索關於 Azure AI 的信息"
- "查找最新的大語言模型發展動態"
- "使用混合模式搜索神經網絡相關資料"

📚 詳細文檔

使用說明

1. 在 Claude 桌面中配置 MCP 服務器：

   {
     "mcpServers": {
       "azure-agent": {
         "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\azure_ai_agent_service_server.py"],
         "env": {
           "AZURE_AI_AGENT_ENDPOINT": "your-endpoint",
           "AZURE_AI_AGENT_KEY": "your-key"
         }
       },
       "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"
         }
       }
     }
   }
   

2. 在 Claude 桌面重啟後，點擊輸入框右側的錘子圖標即可使用 MCP 工具。

故障排除

服務器未顯示：

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

Azure AI Agent Service 問題：

1. 確保 Azure AI Project 配置正確
2. 檢查連接是否已創建並配置完成
3. 驗證 Azure 賬號狀態

自定義服務器

• 修改工具指令：調整每個代理的指令以更改其處理查詢的方式
• 添加新工具：使用 @mcp.tool() 裝飾器集成更多功能
• 自定義響應格式：編輯 Claude 桌面對響應的顯示方式
• 調整網絡搜索參數：優化必應搜索工具的搜索範圍

📄 許可證

此項目基於 MIT License 開源。