Servidor MCP del servicio del agente de IA de Azure

Este servidor MCP se integra con Azure AI Foundry para permitir conexiones a sus agentes de Azure AI existentes, utilizando la amplia gama de modelos y herramientas de conocimiento disponibles en Azure AI Foundry, como Azure AI Search y Bing Web Grounding.

Características

🤖 Integración de agentes : conéctese a sus agentes de IA de Azure existentes
🔄 Flujo de trabajo sin interrupciones : utilice a sus agentes directamente dentro de cualquier cliente MCP
🛡️ Seguro : todas las conexiones usan sus credenciales de Azure
🧠 Memoria de conversación : cada sesión de cliente mantiene un historial de conversación aislado

Herramientas

agente de conexión
- Conectarse a un agente de inteligencia artificial de Azure específico por ID
- Entradas:
  - agent_id (cadena): el identificador del agente de inteligencia artificial de Azure al que conectarse
  - query (cadena): La pregunta o solicitud que se enviará al agente
  - thread_id (cadena, opcional): ID del hilo para la continuación de la conversación
- Devuelve: Respuesta formateada del agente
consulta_predeterminada_agente
- Enviar una consulta al agente configurado por defecto
- Entradas:
  - query (cadena): La pregunta o solicitud que se enviará al agente
  - thread_id (cadena, opcional): ID del hilo para la continuación de la conversación
- Devuelve: Respuesta formateada del agente predeterminado
lista_agentes
- Enumere todos los agentes de IA de Azure disponibles en su proyecto
- Devoluciones: Lista de agentes disponibles con sus ID y nombres

Configuración

Configuración de Azure

Cree agentes de IA de Azure a través de Azure AI Foundry
Anote la cadena de conexión de su proyecto de IA de Azure
Anote las identificaciones de sus agentes (las necesitará para conectarse con agentes específicos)
Autenticación mediante credenciales de Azure: az login

Variables de entorno

Este servidor requiere las siguientes variables de entorno:

# Required
PROJECT_CONNECTION_STRING=your-project-connection-string

# Optional (configure default agent)
DEFAULT_AGENT_ID=your-default-agent-id

Instalación

Prerrequisitos

Python 3.10+
CLI de Azure (az) instalada y configurada
Agentes de inteligencia artificial de Azure existentes con las capacidades deseadas

Configuración

# Setup environment
python -m venv .venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
pip install mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server directly (from ./src/python)
python -m azure_agent_mcp_server

Si prefieres usar uv:

# Setup environment with uv
uv venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
uv add mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server (F)
uv run -m azure_agent_mcp_server

Uso con Claude Desktop

Para utilizar con Claude Desktop, agregue lo siguiente a su archivo de configuración:

{
  "mcpServers": {
    "azure-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "run",
        "-m",
        "azure_agent_mcp_server"
      ],
      "env": {
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

Si no quieres usar uv , puedes usar Python:

{
  "mcpServers": {
    "azure-agent": {
      "command": "python",
      "args": [
        "-m",
        "azure_agent_mcp_server"
      ],
      "cwd": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

Uso con otros clientes MCP

Este servidor cumple con la especificación del protocolo MCP y puede utilizarse con cualquier cliente compatible con MCP. Consulte la documentación de su cliente para obtener instrucciones específicas sobre cómo conectarse a servidores MCP externos.

Notas de desarrollo

Este proyecto sigue una estructura políglota con código Python ubicado en el directorio python. Durante la ejecución o el desarrollo:

Active siempre el entorno virtual desde la raíz del proyecto
Navegue al directorio de Python al ejecutar comandos de Python
Para instalar el paquete, asegúrese de estar en el directorio de Python donde se encuentra pyproject.toml

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite conexiones a agentes de Azure AI dentro de cualquier cliente MCP, lo que permite a los usuarios aprovechar los modelos y las herramientas de conocimiento de Azure AI Foundry, como Azure AI Search y Bing Web Grounding, a través de una interfaz conversacional.

Azure AI Agent Service MCP Server

Servidor MCP del servicio del agente de IA de Azure

Características

Herramientas

Configuración

Configuración de Azure

Variables de entorno

Instalación

Prerrequisitos

Configuración

Uso con Claude Desktop

Uso con otros clientes MCP

Notas de desarrollo

Licencia

Appeared in Searches