aws-knowledge-plus

AWS ナレッジソースのうち、公式 AWS Knowledge MCP Server がインデックスしていないものを対象とする Kiro Power です。

なぜ作られたのか

公式サーバーは無料・認証なし・AWS 運用であり、AWS ドキュメント、AWS ブログ、What's New、Well-Architected、re:Post Knowledge Center の記事をすでにカバーしています。それらを再構築するというのは、サポートされているインターフェースで得られるコンテンツのために、未公開エンドポイントをスクレイピングすることになります。

そこで、この Power は公式サーバーが対象外としているものだけをカバーします。その境界が read_documentation の許可リストです。

Related MCP server: NexusNote MCP Server

前提条件

• uv が PATH にあること（uvx を提供）。この Power には独自の Python は不要で、uv がインタプリタを用意します。

• 上記の「対応」の行に含まれるすべてのコンテンツを提供する、公式 AWS Knowledge MCP Server。この Power は意図的にそのサーバーを宣言しません。すでに導入済みのクライアントが同じエンドポイントへ 2 つ目の接続を開いて、重複したツール一式を読み込むのを防ぐためです。まだ導入していない場合は、~/.kiro/settings/mcp.json に以下の設定を追加してください。

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

インストール

GitHub から（チームに推奨）

1. Kiro → Powers パネル → カスタム Power を追加 → GitHub から Power をインポート

2. このリポジトリの URL を貼り付ける

ローカルクローンから

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

2. Kiro → Powers パネル → カスタム Power を追加 → フォルダーから Power をインポート

3. クローンしたディレクトリを選択

Powers パネルを使わない場合 — ~/.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"]
    }
  }
}

初回起動時は依存関係ツリーの解決に数秒かかります。2 回目以降の起動は uv によってキャッシュされます。

チームでこの Power を使う

この Power はメンテナー以外にとって読み取り専用です。 公開 GitHub リポジトリでは、コラボレーターとして明示的に追加されたアカウントだけが push できますが、そのようなアカウントは存在しません。クローン・インストール・フォークしても、チームメンバーがインストールする内容を変更できる権限は得られません。

インストール先は main ではなくリリースタグに固定されます。 mcp.json は @v0.1.0 を指しているため、main が先に進んでも全メンバーが同じレビュー済みコードを実行します。誰も気づかないうちにアップグレードされることはありません。

変更が必要ですか？ issue または pull request を開いてください。メンテナーがレビュー、マージ、新しいタグの作成を行い、メンバーはピンが更新された時点で新しいバージョンを取り込めます。

メンテナー向けに、新しいバージョンをリリースする手順:

# 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

ツール

検索スニペットは意図的に短くしてあります。スニペットは読むべき記事を選ぶためにあり、その内容から回答するためのものではありません。

読み取り結果の様子

• re:Post — スレッドの schema.org QAPage データから再構築されるため、質問とすべての回答が、著者・日付・投票数・採用回答マーカー付きで得られます。HTML スクレイピングは行わず、コードブロックもそのまま保持されます。

• kiro.dev ドキュメント — 公開されている Markdown 版（/docs/steering は /docs/steering.md を読む）を取得するため、サイトのデザイン装飾を取り除く必要がありません。

• Builder Center — フィードの要約のみで、本文が取得できなかった旨を明示的に示します。

設定

既知の制限

• Builder Center には構造的な制限があります。 唯一の公開インデックスが 30 件の Atom フィードで、その next リンクが自分自身に戻るため、古い投稿を発見できません。記事本文はクライアント側で描画され、取得しません。このためこのソースは低ウェイトで、無効化もできます。

• re:Post の検索深度。 サイトは pageSize は尊重しますが、page には対応しないため、深いページネーションではなく 1 枚の大きなページから返ります。

• 未整備のエンドポイント。 re:Post の検索レスポンスは、ページが埋め込む __NEXT_DATA__ ペイロードから読み取ります。これは公開された API ではなく、今後変わる可能性があります。アダプターは現行の 2 種類のペイロード形式のどちらにも対応し、どちらも見つからない場合はクラッシュせず空の結果を返しますが、サイトの再設計があればここで修正が必要です。

開発

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 は実際のサイトにアクセスするため、さまざまなカナリアの役割も兼ねています。あるソースのマークアップやペイロードが変更された場合、まずここで失敗します。

セキュリティ

アウトバウンドのリクエストは、各アダプターが宣言するホストとパスプレフィックスから作られる許可リストに限定されます。リダイレクトは 1 ホップずつ追跡し、各ホップで再検証するため、リダイレクトによってフェッチャーを許可外のホストへ移動させることはできません。https のみを許可します。リクエストに資格情報を持たず、ソースはすべて公開されています。

ライセンス

Apache-2.0