aws-knowledge-plus

Ein Kiro Power für die AWS-Wissensquellen, die der offizielle AWS Knowledge MCP Server nicht indexiert.

Warum es das gibt

Der offizielle Server ist kostenlos, erfordert keine Authentifizierung, wird von AWS gepflegt und deckt bereits AWS-Dokumentation, AWS-Blogs, What's New, Well-Architected und Artikel des re:Post Knowledge Center ab. Das alles neu aufzubauen würde bedeuten, undokumentierte Endpunkte zu scrapen, nur um Inhalte zu erhalten, die bereits über eine unterstützte Schnittstelle verfügbar sind.

Dieses Power deckt also nur das ab, was der offizielle Server nicht abdeckt. Seine read_documentation-Allowlist ist die maßgebliche Grenze:

Related MCP server: NexusNote MCP Server

Voraussetzungen

• uv liegt im PATH (stellt uvx bereit). Das Power benötigt kein eigenes Python; uv besorgt einen Interpreter.

• Der offizielle AWS Knowledge MCP Server für alles in den oben als „Abgedeckt“ markierten Zeilen. Dieses Power deklariert ihn bewusst nicht, damit Clients, die ihn bereits besitzen, keine zweite Verbindung zum selben Endpunkt aufbauen und keinen doppelten Tool-Satz laden. Falls du ihn noch nicht hast, füge Folgendes zu ~/.kiro/settings/mcp.json hinzu:

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

Installation

Von GitHub (für Teams empfohlen)

1. Kiro → Powers-Panel → Benutzerdefiniertes Power hinzufügen → Power aus GitHub importieren

2. Füge die URL dieses Repositorys ein

Aus einem lokalen Klon

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

2. Kiro → Powers-Panel → Benutzerdefiniertes Power hinzufügen → Power aus einem Ordner importieren

3. Wähle das geklonte Verzeichnis aus.

Ohne das Powers-Panel – füge den Server direkt zu ~/.kiro/settings/mcp.json hinzu:

{
  "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"]
    }
  }
}

Der erste Start löst den Abhängigkeitsbaum auf und dauert ein paar Sekunden; weitere Starts werden von uv gecacht.

Dieses Power im Team nutzen

Dieses Power ist bis auf den Maintainer für alle nur lesbar. Auf einem öffentlichen GitHub-Repository können nur Konten puschen, die ausdrücklich als Kollaboratoren hinzugefügt wurden – und das ist niemand. Klonen, Installieren und Forken verleihen keine Möglichkeit, das zu ändern, was die Teamkollegen installieren.

Installationen sind an ein Release-Tag gebunden, nicht an main. Die mcp.json verweist auf @v0.1.0, damit jedes Teammitglied denselben geprüften Code ausführt, auch während main weiterzuentwickelt wird. Niemand wird leise aktualisiert.

Änderung nötig? Öffne ein Issue oder einen Pull Request. Der Maintainer überprüft, mergen ihn, merged ihn und legt ein neues Tag an; die Teamkolleg:innen übernehmen es, sobald der Pin aktualisiert wird.

Eine neue Version veröffentlichen (für den Maintainer):

# 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

Tools

Suchergebnisse sind bewusst kurz gehalten: Sie sollen bei der Auswahl helfen, was du lesen möchtest, nicht als Antwortmittel in die Are dienen.

Wie das Lesen aussieht

• re:Post – wird aus den strukturierten QAPage-Daten des Threads aufgebaut, sodass du die Frage plus alle Antworten mit Autoren, Daten, Abstimmungsergebnissen und dem Marker für die akzeptierte Antwort bekommst. Ohne HTML-Scraping; Codeblöcke bleiben unverändert.

• kiro.dev-Doku – wird aus dem veröffentlichten Markdown-Gegenstück geholt (/docs/steering liest /docs/steering.md), sodass keine Seiten-Chrome zu entfernen ist.

• Builder Center – nur die Feed-Zusammenfassung, mit dem Hinweis, dass der Beitragstext selbst nicht abgerufen wurde. Der Beitragskörper ist daher inhaltlich nicht erfasst.

Konfiguration

Bekannte Einschränkungen

• Der Builder Center ist strukturell begrenzt. Sein einziger öffentlicher Index ist ein Atom-Feed mit 30 Einträgen, dessen next-Link auf sich selbst zurückweist, sodass ältere Beiträge nicht aufgefunden werden können. Artikeltexte werden clientseitig gerendert und deshalb nicht abgerufen. Das ist der Grund, warum die Quelle eine niedrige Gewichtung hat und deaktiviert werden kann.

• Tiefe der re:Post-Suche: Die Website honoriert pageSize, aber nicht page. Die Ergebnisse stammen also aus einer einzelnen größeren Seite und nicht aus einer tiefen Pagination.

• Undokumentierte Endpunkte: Die Suchantwort von re:Post wird aus dem __NEXT_DATA__- Payload gelesen, den die Seite selbst einbettet. Das ist keine veröffentlichte API und kann sich ändern. Der Adapter toleriert beide derartzeitig ausgegebenen Payload-Varianten und liefert ein leeres Ergebnis, statt abzustürzen, wenn keines erkannt wird; ein redesign der News Seite würde aber eine Korrektur hier erfordern.

Entwicklung

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 greift auf die echten Websites zu und ist damit zugleich ein Indikator: Wenn sich Markup oder Payload einer Quelle ändert, schlägt dort zuerst der Fehl an.

Sicherheit

Ausgehende Anfragen sind auf eine Allowlist beschränkt, die aus den deklarierten Host- und Pfad-Präfixen jedes Adapters aufgebaut ist. Redirects werden Sprung für Sprung verfolgt und jeder Sprung die neue auseinandergefügt, sodass ein Redirect den Abholer nicht auf einen nicht gelisteten Host führen kann. Es ist nur https:// erlaubt. Anfragen enthalten keine Anmeldedaten, und die Quellen sind alle öffentlich.

Lizenz

Apache-2.0