AWS Knowledge Base Retrieval

Recupera información de una base de conocimiento de AWS utilizando el Bedrock Agent Runtime.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Recuperación de AWS Knowledge Base

Un servidor MCP para recuperar información de AWS Knowledge Base utilizando el Bedrock Agent Runtime.

Características

  • RAG (Generación Aumentada por Recuperación): Recupera contexto de AWS Knowledge Base basado en una consulta y un ID de Knowledge Base.
  • Soporta recuperación de múltiples resultados: Opción para recuperar un número personalizable de resultados.

Herramientas

  • retrieve_from_aws_kb
    • Realiza operaciones de recuperación utilizando AWS Knowledge Base.
    • Entradas:
      • query (cadena): La consulta de búsqueda para la recuperación.
      • knowledgeBaseId (cadena): El ID de AWS Knowledge Base.
      • n (número, opcional): Número de resultados a recuperar (predeterminado: 3).
    • Formato de respuesta:
      • La respuesta ahora devuelve dos elementos de contenido separados:
        • Un elemento de texto que contiene el contexto sin procesar de la base de conocimiento.
        • Un elemento JSON que contiene las fuentes RAG estructuradas con metadatos (id, fileName, snippet y score).
      • Esta separación permite un procesamiento más flexible de los resultados.

Configuración

Configuración de credenciales de AWS

Tiene dos opciones para configurar las credenciales de AWS:

Opción 1: Claves de acceso IAM

  1. Obtenga el ID de clave de acceso de AWS, la clave de acceso secreta y la región desde la consola de administración de AWS.
  2. Asegúrese de que estas credenciales tengan los permisos adecuados para las operaciones de Bedrock Agent Runtime.
  3. Establezca las variables de entorno como se muestra en los ejemplos de configuración a continuación.
  4. Para credenciales temporales, también puede proporcionar un token de sesión utilizando la variable de entorno AWS_SESSION_TOKEN.

Opción 2: AWS SSO (Inicio de sesión único)

El servidor ahora admite credenciales de AWS SSO:

  1. Configure la CLI de AWS con su perfil SSO: aws configure sso
  2. Establezca solo la variable de entorno AWS_REGION en la configuración del servidor MCP.
  3. El servidor utilizará la cadena de proveedores de credenciales predeterminada, que incluye credenciales SSO.

Opcional: Configurar IDs de Knowledge Base predeterminados

Opcionalmente, puede especificar uno o más IDs de Knowledge Base para usar por defecto:

  1. Cree una matriz de IDs de Knowledge Base en formato JSON.
  2. Establezca esto como la variable de entorno AWS_KB_IDS en su configuración.
  3. Cuando esto esté configurado, el parámetro knowledgeBaseId se vuelve opcional en la herramienta.

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json:

Docker con claves de acceso IAM

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "docker",
      "args": [ "run", "-i", "--rm", "-e", "AWS_ACCESS_KEY_ID", "-e", "AWS_SECRET_ACCESS_KEY", "-e", "AWS_REGION", "-e", "AWS_KB_IDS", "mcp/aws-kb-retrieval-server" ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_SESSION_TOKEN": "YOUR_OPTIONAL_SESSION_ID_FOR_SSO_TEMPORARY_CREDENTIALS_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE",
        "AWS_KB_IDS": "[\"kb-12345\", \"kb-67890\"]"
      }
    }
  }
}

Docker con AWS SSO

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "docker",
      "args": [ "run", "-i", "--rm", "-e", "AWS_REGION", "-e", "AWS_KB_IDS", "-v", "${HOME}/.aws:/root/.aws", "mcp/aws-kb-retrieval-server" ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_SESSION_TOKEN": "YOUR_OPTIONAL_SESSION_ID_FOR_SSO_TEMPORARY_CREDENTIALS_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE",
        "AWS_KB_IDS": "[\"kb-12345\", \"kb-67890\"]"
      }
    }
  }
}

NPX con claves de acceso IAM

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-kb-retrieval"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_SESSION_TOKEN": "YOUR_OPTIONAL_SESSION_ID_FOR_SSO_TEMPORARY_CREDENTIALS_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE",
        "AWS_KB_IDS": "[\"kb-12345\", \"kb-67890\"]"
      }
    }
  }
}

NPX con AWS SSO

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-kb-retrieval"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_SESSION_TOKEN": "YOUR_OPTIONAL_SESSION_ID_FOR_SSO_TEMPORARY_CREDENTIALS_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE",
        "AWS_KB_IDS": "[\"kb-12345\", \"kb-67890\"]"
      }
    }
  }
}

Repositorio local (desde repositorio clonado/compilado)

{
  "mcpServers": {
    "aws-kb": {
      "command": "node",
      "args": [
        "/path/to/mcp-aws-kb/dist/index.js"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_SESSION_TOKEN": "YOUR_OPTIONAL_SESSION_ID_FOR_SSO_TEMPORARY_CREDENTIALS_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE",
        "AWS_KB_IDS": "[\"kb-12345\", \"kb-67890\"]"
      },
      "disabled": false,
      "autoApprove": [
        "retrieve_from_aws_kb"
      ],
      "timeout": 120
    }
  }
}

Compilación

Docker:

docker build -t mcp/aws-kb-retrieval -f src/aws-kb-retrieval-server/Dockerfile .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre 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 LICENSE en el repositorio del proyecto.

Este README asume que su paquete de servidor se llama @modelcontextprotocol/server-aws-kb-retrieval. Ajuste el nombre del paquete y los detalles de instalación si difieren en su configuración. Además, asegúrese de que su script de servidor esté correctamente compilado y que todas las dependencias estén gestionadas adecuadamente en su package.json.