基本能力
产品定位
mcp-server-azure-ai-agents 是一个连接 Claude Desktop 与 Azure AI 服务的 MCP 服务器,提供强大的搜索功能,包括私有文档搜索和公共网络搜索。
核心功能
- Azure AI Agent Service 实现(推荐)
- Azure AI 搜索工具:搜索索引文档,提供 AI 增强的结果
-
Bing 网络搜索工具:搜索网络内容,并提供来源引用
-
直接 Azure AI Search 实现
- 关键词搜索:精确的词法匹配
- 向量搜索:使用嵌入的语义相似性搜索
- 混合搜索:关键词和向量搜索的组合
适用场景
- 在 Claude Desktop 中快速搜索私有文档和公共网络内容
- AI 和 LLM 相关的研究和开发
- 需要高效搜索和引用来源的场景
工具列表
- Azure AI 搜索工具:搜索私有文档,提供 AI 增强的结果
- Bing 网络搜索工具:搜索网络内容,并提供来源引用
- 关键词搜索工具:精确的词法匹配搜索
- 向量搜索工具:语义相似性搜索
- 混合搜索工具:结合关键词和向量搜索
常见问题解答
- 服务器未出现:检查 Claude Desktop 日志,验证文件路径和环境变量
- Azure AI Agent Service 问题:确保 Azure AI 项目配置正确,验证连接和认证状态
使用教程
使用依赖
- Python:版本 3.10 或更高
- Claude Desktop:最新版本
- Azure 资源:
- Azure AI Search 服务
- Azure AI 项目(用于 Agent Service)
安装教程
-
创建项目目录
bash
mkdir mcp-server-azure-ai-search
cd mcp-server-azure-ai-search -
创建 .env 文件
bash
echo "PROJECT_CONNECTION_STRING=your-project-connection-string" > .env
echo "MODEL_DEPLOYMENT_NAME=your-model-deployment-name" >> .env
echo "AI_SEARCH_CONNECTION_NAME=your-search-connection-name" >> .env
echo "BING_CONNECTION_NAME=your-bing-connection-name" >> .env
echo "AI_SEARCH_INDEX_NAME=your-index-name" >> .env -
设置虚拟环境
bash
uv venv
.venv\Scripts\activate
uv pip install "mcp[cli]" azure-identity python-dotenv azure-ai-projects
调试方式
- 重启 Claude Desktop 以加载新配置
- 在输入框的右下角查找 MCP 工具图标(锤子图标)
- 尝试查询,例如:
- "Search for information about AI in my Azure Search index"
- "Search the web for the latest developments in LLMs"