cloudkb

cloudkb

Amazon Bedrock ナレッジベースを MCP ツールとして提供します。cloudkb は、AWS Bedrock ナレッジベース MCP サーバーのコア機能をクリーンルーム方式で再構築したもので、新しい名前で提供します。ツール名とドキュメントに記載された REST リクエストの形式は同じですが、コードは新しく、ブランド表現はコピーしていません。

ツール（コアサブセット、10 個）

list_knowledge_bases、get_knowledge_base、list_data_sources、 get_data_source、list_ingestion_jobs、get_ingestion_job、 start_ingestion_job、stop_ingestion_job、retrieve、 retrieve_and_generate。

最初の 8 つのツールは Bedrock Agent（コントロールプレーン）リクエストを構成し、 retrieve と retrieve_and_generate は Bedrock Agent Runtime （データプレーン）リクエストを構成します。リクエストの構成は実装され、ユニットテスト済みです。すべての呼び出しは、注入可能なエグゼキューターインターフェースを経由します。

このサブセットに含まれないもの：ナレッジベースとデータソースの作成、更新、削除のライフサイクル、チャンク分割の設定、エージェントとエイリアス、フロー、 プロンプト、ガードレール、評価ジョブ、モデル呼び出し、セッション。

セットアップ

export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1   # optional, this is the default

認証情報がない場合、すべてのツール呼び出しは AWS_ACCESS_KEY_ID を示すエラーで失敗します。

署名に関する制限を明記します： この再構築版では SigV4 署名を実装していません。署名は注入可能な署名フック／エグゼキューターフックに委譲されます。認証情報があっても署名機能が注入されていない場合、未署名のリクエストは送信されず、代わりに SigV4 signing not configured: inject a signer/executor というエラーで呼び出しが失敗します。

CLI

npx @reneturcios/cloudkb list_knowledge_bases '{}'
npx @reneturcios/cloudkb retrieve '{"knowledge_base_id":"KB1","query":"refund policy"}'
npx @reneturcios/cloudkb mcp        # stdio MCP server

各ツール名は、JSON オブジェクト引数を 1 つ取るサブコマンドです。

MCP クライアント設定

{
  "mcpServers": {
    "cloudkb": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cloudkb", "mcp"],
      "env": { "AWS_ACCESS_KEY_ID": "...", "AWS_SECRET_ACCESS_KEY": "...", "AWS_REGION": "us-east-1" }
    }
  }
}

Docker

docker run -i -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY ghcr.io/cloudcorprecords/cloudkb

開発

npm install
npm run build
npm test

ライセンス

MIT