aws-knowledge-plus

Un Kiro Power para las fuentes de conocimiento de AWS que el servidor oficial AWS Knowledge MCP Server no indexa.

Por qué existe

El servidor oficial es gratuito, no requiere autenticación, lo mantiene AWS y ya cubre la documentación de AWS, los blogs de AWS, What's New, Well-Architected y los artículos del re:Post Knowledge Center. Reconstruir cualquiera de eso implicaría extraer de endpoints no documentados contenido que ya está disponible a través de una interfaz compatible.

Así que este power cubre únicamente lo que el servidor oficial rechaza. Su lista de permitidos read_documentation es el límite autoritativo:

Related MCP server: NexusNote MCP Server

Requisitos

• uv en PATH (proporciona uvx). El power no necesita un Python propio; uv descarga un intérprete.

• El servidor oficial AWS Knowledge MCP Server para todo lo que está en las filas de «Cubierto» de arriba. Este power deliberadamente no lo declara, para que los clientes que ya lo tienen no abran una segunda conexión al mismo endpoint y carguen un duplicado de herramientas. Si todavía no lo tienes, añade esto a ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "aws-knowledge": {
      "url": "https://knowledge-mcp.global.api.aws"
    }
  }
}

Instalación

Desde GitHub (recomendado para equipos)

1. Kiro → Panel de Powers → Añadir Power personalizado → Importar power desde GitHub

2. Pega la URL de este repositorio

Desde un clon local

1. git clone https://github.com/hey-iam-ryan/kiro-power-aws-knowledge-plus

2. Kiro → Panel de Powers → Añadir Power personalizado → Importar power desde una carpeta

3. Selecciona el directorio clonado

Sin el panel de Powers — añade el servidor directamente a ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "aws-knowledge-plus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hey-iam-ryan/kiro-power-aws-knowledge-plus@v0.1.0",
        "aws-knowledge-plus-mcp"
      ],
      "autoApprove": ["search_aws_knowledge", "read_aws_content", "list_sources"]
    }
  }
}

El primer arranque resuelve el árbol de dependencias y tarda unos segundos; los arranques posteriores quedan en caché gracias a uv.

Uso de este power en un equipo

Este power es de solo lectura para todos excepto el mantenedor. en un repositorio público de GitHub, solo las cuentas añadidas explícitamente como colaboradores pueden hacer push, y no hay ninguna. Clonar, instalar y hacer fork no otorgan ninguna capacidad para cambiar lo que tus compañeros de equipo instalan.

Las instalaciones apuntan a una etiqueta de versión, no a main. mcp.json apunta a @v0.1.0, de modo que todos los miembros del equipo ejecutan el mismo código revisado incluso mientras main avanza. Nadie es actualizado en silencio.

¿Necesitas un cambio? Abre un issue o un pull request. El mantenedor lo revisa, lo mezcla y recorta una nueva etiqueta; los compañeros lo recogen cuando se actualiza el pin.

Enviar una nueva versión, para el mantenedor:

# after merging changes to main
uv run python smoke_test.py            # must pass: it hits the live sources
git tag v0.2.0 && git push origin v0.2.0
# then bump the @v0.1.0 pin in mcp.json and README.md, commit, and push

Herramientas

Los fragmentos de búsqueda son intencionadamente cortos: sirven para ayudar a elegir qué leer, no para responder desde ellos.

Cómo son las lecturas

• re:Post — reconstruido a partir de los datos QAPage del esquema.org de la historia, así obtienes la pregunta más cada respuesta con autores, fechas, contadores de votos y el marcador de respuesta aceptada. Error free de HTML, y los bloques de código se conservan intactos.

• Documentación de kiro.dev — se obtiene del gemelo Markdown publicado (/docs/steering lee /docs/steering.md), de modo que no hay «chrome» del sitio que eliminar.

• Builder Center — solo resumen del feed, con una nota explícita de que el cuerpo no se ha recuperado.

Configuración

Limitaciones conocidas

• El Builder Center está estructuralmente limitado. Su único índice público es un feed Atom de 30 entradas cuyo enlace next se repite sobre sí mismo, de modo que las publicaciones más antiguas no se pueden localizar. Los cuerpos de los artículos se renderizan en el lado del cliente y no se recuperan. Por eso esta fuente tiene poco peso y puede desactivarse.

• Profundidad de búsqueda en re:Post. El sitio respe return pageSize sin page, por lo que los resultados provienen de una única página más grande en lugar de una paginación profunda.

• Endpoints no documentados. La respuesta de búsqueda de re:Post se lee del payload __NEXT_DATA__ que su propia página inserta. No es una API pública y puede cambiar. El adaptador tolera ambas formas de payload que actualmente emite y devuelve un resultado vacío en lugar de bloquearse si no se encuentra ninguna; pero un rediseño del sitio necesitaría una corrección aquí.

Desarrollo

uv sync
uv run python smoke_test.py     # live checks against all three sources
uv run aws-knowledge-plus-mcp   # start on stdio

smoke_test.py hace peticiones a los sitios reales, por lo que sirve además como canario: si una fuente cambia su estructura o su payload, falla primero aquí.

Seguridad

Las peticiones salientes están restringidas a la lista de permitidos que se construye a partir de la raíz del host y de los prefijos de ruta declarados por cada adaptador. Las redirecciones se siguen un salto a la vez y cada salto se vuelve a validar, de modo que una redirección no puede llevar al buscador hacia un host no enumerado. Solo se acepta https. Las peticiones no llevan credenciales, y todas las fuentes son públicas.

Licencia

Apache-2.0