Provides tools for querying Amazon Bedrock Knowledge Base using the Retrieve API, enabling search and retrieval of document chunks with content, location, and relevance scores.
kk-bedrock-agent-hub-mcp
Amazon Bedrock Knowledge Base にクエリを送信する MCP (Model Context Protocol) サーバーです。
概要
kk-bedrock-agent-hub-mcp は、AI アシスタント(Claude Desktop、Cursor、Kiro)が Amazon Bedrock Knowledge Base から情報を取得できるようにする kb_answer ツールを提供します。
注意: このサーバーは Retrieve API を使用し、純粋な検索機能のみを提供します。回答生成(RetrieveAndGenerate)は行わず、基盤モデル ARN は不要です。
機能
Bedrock Retrieve API を使用した Knowledge Base 検索
環境変数ベースの設定管理
検索結果(コンテンツ、ロケーション、スコア)の抽出と返却
入力バリデーション
環境変数
変数名 | 必須 | デフォルト | 説明 |
| いいえ |
| AWS リージョン |
| はい | - | Knowledge Base ID |
| いいえ | - | AWS 認証プロファイル |
環境変数の設定例
インストール
方法1: Git Clone(推奨)
方法2: pip で直接インストール
使用方法
直接実行
コマンドラインから実行(pip インストール後)
MCP クライアント設定
クローンしたディレクトリの絶対パスを指定してください。
Claude Desktop
claude_desktop_config.json に以下を追加:
Cursor
.cursor/mcp.json に以下を追加:
Kiro
~/.kiro/settings/mcp.json(グローバル)または .kiro/settings/mcp.json(ワークスペース)に以下を追加:
Windows の場合
パスはスラッシュ / またはダブルバックスラッシュ \\ を使用:
AWS_PROFILE を使用する場合
AWS 認証プロファイルを指定する場合は AWS_PROFILE 環境変数を追加:
kb_answer ツール
パラメータ
パラメータ | 型 | 必須 | デフォルト | 説明 |
| string | はい | - | Knowledge Base に送信するクエリ文字列 |
| integer | いいえ | 4 | 取得するソースチャンクの最大数(1-10) |
使用例
レスポンス形式
検索結果は以下の形式で返されます:
開発
テスト実行
プロジェクト構造
ライセンス
MIT