使用说明

项目简介

本项目是一个 MCP (Model Context Protocol) 服务器，旨在将 Claude Desktop 智能助手与 Azure AI Search 服务连接起来。通过这个服务器，Claude 可以利用 Azure AI Search 强大的搜索能力，检索和理解您的 Azure 知识库中的信息，从而更好地回答问题和执行任务。

主要功能点

无缝集成 Claude Desktop: 让 Claude Desktop 能够轻松访问和利用 Azure AI Search 的功能。
多种搜索模式: 支持关键词搜索、向量搜索和混合搜索，满足不同的信息检索需求。
灵活定制: 易于扩展新的工具或修改搜索逻辑，以适应不同的应用场景。

安装步骤

创建项目目录:

mkdir mcp-server-azure-ai-search
cd mcp-server-azure-ai-search

创建 '.env' 配置文件: 在项目目录下创建 '.env' 文件，并填入您的 Azure AI Search 服务配置信息：

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

请替换 'your-service-name'、'your-index-name' 和 'your-api-key' 为您实际的 Azure AI Search 服务信息。

设置虚拟环境:

uv venv
.venv\Scripts\activate

安装依赖:

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

服务器配置

要让 Claude Desktop 连接到这个 MCP 服务器，您需要在 Claude Desktop 的开发者配置中添加以下服务器配置信息。打开 Claude Desktop 的设置，导航到 'Settings > Developer > Edit Config'，添加或修改 'mcpServers' 部分：

{
  "mcpServers": {
    "azure-search": {
      "command": "C:\\path\\to\\mcp-server-azure-ai-search\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\mcp-server-azure-ai-search\\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-search"': 服务器名称，您可以自定义，Claude Desktop 通过此名称识别服务器。
'"command"': Python 解释器路径。请将 'C:\path\to\mcp-server-azure-ai-search' 替换为您实际的项目路径。
'"args"': 服务器脚本路径。请将 'C:\path\to\mcp-server-azure-ai-search' 替换为您实际的项目路径。
'"env"': 环境变量。这些环境变量将传递给服务器进程，用于配置 Azure AI Search 连接。请确保这里的配置与您在 '.env' 文件中配置的一致。

注意: 请务必将 'C:\path\to\mcp-server-azure-ai-search' 替换为您的实际项目路径。根据您的操作系统，路径格式可能需要调整。

基本使用方法

重启 Claude Desktop: 使新的服务器配置生效。
查找 MCP 工具图标: 在 Claude Desktop 输入框的右下角，您应该能看到一个锤子图标，表示 MCP 工具已加载。
使用搜索功能: 您现在可以向 Claude 提出问题，并指示它使用 Azure AI Search 进行搜索。例如：
- "请使用 Azure Search 搜索关于人工智能的信息。"
- "用向量搜索工具查找关于向量数据库的资料。"
- "使用混合搜索查找关于神经网络的信息。"

Claude 将调用配置的 MCP 服务器，使用 Azure AI Search 执行搜索，并将结果返回给您。

关键词