Servicio de agente de inteligencia artificial de Azure + Servidor MCP de Azure AI Search

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude Desktop buscar en su contenido mediante servicios de IA de Azure. Elija entre el Servicio de Agente de IA de Azure (con búsqueda en documentos y web) o la integración directa con Azure AI Search.

Descripción general

Este proyecto proporciona dos implementaciones de servidor MCP para conectar Claude Desktop con las capacidades de búsqueda de Azure:

1. Implementación del servicio del agente de IA de Azure (recomendado) : utiliza el potente servicio del agente de IA de Azure para proporcionar:
   • Herramienta de búsqueda de IA de Azure : busque sus documentos indexados con resultados mejorados con IA
   • Herramienta de base web de Bing : busca en la web con citas de fuentes
2. Implementación directa de Azure AI Search : se conecta directamente a Azure AI Search con tres métodos:
   • Búsqueda de palabras clave : coincidencias léxicas exactas
   • Búsqueda vectorial : similitud semántica mediante incrustaciones
   • Búsqueda híbrida : combinación de búsquedas de palabras clave y vectores

Características

• Búsqueda mejorada con IA : el servicio del Agente de IA de Azure optimiza los resultados de búsqueda con procesamiento inteligente
• Múltiples fuentes de datos : busque tanto en sus documentos privados como en la web pública
• Citas de fuentes : los resultados de búsqueda web incluyen citas de fuentes originales
• Implementación flexible : elija entre el servicio Azure AI Agent o la integración directa con Azure AI Search
• Integración perfecta con Claude : todas las funciones de búsqueda son accesibles a través de la interfaz de Claude Desktop
• Personalizable : fácil de ampliar o modificar el comportamiento de búsqueda

Enlaces rápidos

• Introducción a Azure AI Search
• Guía de inicio rápido del servicio Agente de IA de Azure

Requisitos

• Python: versión 3.10 o superior
• Claude Desktop: última versión
• Recursos de Azure:
  • Servicio de búsqueda de IA de Azure con un índice que contiene datos de texto vectorizados
  • Para el servicio de agente: Proyecto de IA de Azure con conexiones de Azure AI Search y Bing
• Sistema operativo: Windows o macOS (instrucciones proporcionadas para Windows, pero adaptables)

Implementación del servicio del agente de IA de Azure (recomendado)

Guía de configuración

1. Directorio de proyectos:
   mkdir mcp-server-azure-ai-search cd mcp-server-azure-ai-search
2. Crear un archivo .env :
   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
3. Configurar entorno virtual:
   uv venv .venv\Scripts\activate uv pip install "mcp[cli]" azure-identity python-dotenv azure-ai-projects
4. Utilice el script azure_ai_agent_service_server.py para la integración con el servicio Azure AI Agent.

Configuración del servicio del agente de inteligencia artificial de Azure

Antes de utilizar la implementación, necesitas:

1. Crear un proyecto de IA de Azure:
   • Vaya al Portal de Azure y cree un nuevo proyecto de IA de Azure
   • Tenga en cuenta la cadena de conexión del proyecto y el nombre de implementación del modelo
2. Crear una conexión de Azure AI Search:
   • En su proyecto de IA de Azure, agregue una conexión a su servicio de búsqueda de IA de Azure
   • Tenga en cuenta el nombre de la conexión y el nombre del índice
3. Crear una conexión de búsqueda web de Bing:
   • En su proyecto de IA de Azure, agregue una conexión al servicio de búsqueda de Bing
   • Tenga en cuenta el nombre de la conexión
4. Autenticarse con Azure:
   az login

Configuración de Claude Desktop

Nota: reemplace los marcadores de ruta con las rutas de su proyecto real.

Implementación directa de Azure AI Search

Para aquellos que prefieren la integración directa de Azure AI Search sin el servicio de agente:

1. Crea un archivo .env diferente:
   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
2. Dependencias de instalación:
   uv pip install "mcp[cli]" azure-search-documents==11.5.2 azure-identity python-dotenv
3. Utilice el script azure_search_server.py para la integración directa con Azure AI Search.
4. Configurar Claude Desktop:
   { "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" } } } }

Probando el servidor

1. Reinicie Claude Desktop para cargar la nueva configuración
2. Busque el ícono de herramientas MCP (ícono de martillo) en la parte inferior derecha del campo de entrada
3. Pruebe consultas como:
   • Buscar información sobre IA en mi índice de Azure Search
   • Busque en la web las últimas novedades en LLM.
   • Encuentre información sobre redes neuronales mediante la búsqueda híbrida.

Solución de problemas

• El servidor no aparece:
  • Consulte los registros de Claude Desktop (ubicados en %APPDATA%\Claude\logs\mcp*.log en Windows)
  • Verificar las rutas de archivos y las variables de entorno en la configuración
  • Pruebe ejecutando el servidor directamente: python azure_ai_agent_service_server.py o uv run python azure_ai_agent_service_server.py
• Problemas del servicio del agente de inteligencia artificial de Azure:
  • Asegúrese de que su proyecto de IA de Azure esté configurado correctamente
  • Verificar que las conexiones existan y estén configuradas correctamente
  • Comprueba tu estado de autenticación de Azure

Personalización de su servidor

• Modificar instrucciones de la herramienta: ajuste las instrucciones proporcionadas a cada agente para cambiar la forma en que procesan las consultas
• Agregar nuevas herramientas: use el decorador @mcp.tool() para integrar herramientas adicionales
• Personalizar el formato de respuesta: edite cómo se formatean las respuestas y se devuelven a Claude Desktop
• Ajustar los parámetros de búsqueda web: modificar la herramienta de búsqueda web para centrarse en dominios específicos

Licencia

Este proyecto está licenciado bajo la licencia MIT.