AWS Qindex MCP Server

AWS Qindex MCP Server

AWS Qindex MCPサーバーは、AIアプリケーションがモデルコンテキストプロトコルを通じてAmazon Q Indexデータに安全かつシームレスにアクセスできるようにします。これにより、言語モデルやエージェントアシスタントは、企業の文書インデックスに対して自然言語の検索、取得、分析を行うことができます。

Author: awslabs


プロトコルを表示

AWS Qindex MCPサーバーとは？

AWS Qindex MCPサーバーは、標準化されたモデルコンテキストプロトコル（MCP）を介してAmazon Q Indexの検索とデータ取得機能を提供する専門的なサーバーコンポーネントです。これにより、AIエージェント、LLMベースのコーディングアシスタント、オートメーションツールは、Q Indexをコンテキストデータソースとして統合できます。これにより、意味的な文書検索を簡単に行い、索引のコーパスから質問に答え、生成AIワークフローで企業の知識を活用できます。

設定方法

AWS Qindex MCPサーバーをセットアップするには：

  1. 前提条件：
    • Pythonがインストールされていることを確認します（uvの使用を推奨）。
    • Q Indexにアクセスするための権限を持つAWSプロファイル/資格情報が設定されていること。
    • アプリケーションの要件に応じて、uvxまたはDockerコンテナを使用してMCPサーバーをインストールします。
  2. MCPクライアント設定に追加： MCPクライアントの設定ファイル（例：~/.aws/amazonq/mcp.json、.cursor/mcp.jsonなど）にエントリを追加します： 
    {
  "mcpServers": {
    "awslabs.qindex-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.qindex-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "your-aws-region",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}
  3. 環境変数と権限：
    • 必要に応じてAWS_PROFILEとAWS_REGIONの値を設定します。
    • IAMユーザーまたはロールがAmazon Q Index APIにアクセスできることを確認します。
    • オプションで、ワークフローに必要な特定のQ Index識別子やカスタム環境変数を設定します。
  4. 接続のテスト： MCPクライアントのインターフェースを使用して、サーバーが発見可能であり、/tools/listにある利用可能なツールが返されるか確認します。

使い方

  1. エージェントアシスタントの統合：
    • AIコーディングアシスタントやチャットインターフェースを介して、自然言語のプロンプトでQ Indexからの検索や取得を呼び出します。
    • LLMはMCPプロトコルを使用してQindexサーバーに関連する文書や回答を照会します。
  2. 直接ツールの呼び出し：
    • MCPクライアントを介してtools/listで利用可能な機能（ツール）をリストします。
    • tools/callエンドポイントを使用してQ Index検索操作を呼び出し、キーワードや文書フィルターのようなクエリパラメータを渡します。
    • チャットの例:"Qindex MCPサーバーを使用して、AWS Lambdaの最近のアーキテクチャガイドラインを検索します。"
  3. コンテキスト完成：
    • 有効にすると、Q Indexからの結果を言語モデルのコンテキストウィンドウに埋め込むことで、コード、文書、または研究結果の正確性と事実確認を向上させます。
  4. マルチエージェントワークフロー：
    • Qindex MCPサーバーからの応答を他のMCPサーバー（例：AWS文書またはコスト分析）と組み合わせて、高度なドメイン横断的推論および自動化を行います。

主要機能

  • **リアルタイムの意味検索：**企業のQ Index上での自然言語またはキーワードに基づくクエリ。
  • **LLM対応の構造化結果：**構造化コンテキストとしてデータを返し、LLMプロンプトやエージェントワークフローに注入する準備が整います。
  • **認可の継承：**既存のAWS IAMを利用して、詳細で安全なデータアクセスを提供します。
  • **企業知識の統合：**組織のQ Indexの知識をAI駆動のコーディングアシスタントやエージェントにシームレスに提供します。
  • **ツール発見と呼び出し：**索引化されたコンテンツを検索、フィルタリング、取得するための発見可能な合成機能（MCPツール）を提供します。
  • **引用と参考文献：**結果にはソース/文書のメタデータが含まれ、正確な追跡と監査が可能です。
  • **他のMCPサーバーとの合成：**フルスタックAI開発のための補完的なコンテキスト/データプロバイダーとの柔軟な統合。

ユースケース

  • **企業知識の検索：**自然言語でキュレーションされたQ Indexを検索することで、ビジネス、エンジニアリング、コンプライアンスの質問に即座に回答します。
  • **研究アシスタント：**文書化された最新のアーキテクチャパターン、セキュリティガイドライン、またはベストプラクティスを取得し、コンテキストに配慮したコード生成を行います。
  • **対話型Q&A：**チャットボット、バーチャルアシスタント、またはサポートエージェントを強化し、権威ある内部文書に基づいて応答を確立させます。
  • **自動コード生成：**Q Indexから取得した組織特有の参照やベストプラクティスでLLMのコード出力を補完します。
  • **コンプライアンスとセキュリティ監査：**監査やコンプライアンスの問い合わせに応じて、関連するポリシーや文書を迅速に見つけます。
  • **カスタムワークフロー：**アマゾンQ Indexから取得された情報が、他のMCP統合ツールのアクションを導いたり制約したりするマルチツールチェーンを可能にします。

FAQ

Q1: AWS Qindex MCPサーバーを実行するために必要な権限は何ですか？
Amazon Q Indexデータにアクセスするには、AWSプロファイルまたは資格情報が関連するQ Index API（qindex:Searchや同様の詳細な権限など）に対する権限を持っている必要があります。適切なアクセスを確保するためにセキュリティチームに相談してください。

Q2: Qindex MCPサーバーを複数のQ Indexまたはテナントで使用できますか？
はい、必要に応じて異なるQ Index識別子を指定するか、MCPクライアント設定に複数のエントリを構成して異なるQ Indexデータソースにクエリをルーティングできます。

Q3: AWS Qindex MCPサーバーは機密データや制限されたデータをどのように扱いますか？
データアクセス、フィルタリング、認可は、あなたのAWSセキュリティコンテキストを使用して強制されます。基盤となるQ Indexおよびその文書に対して適切な権利を持つユーザーまたはロールのみが一致する結果を取得できます。

Q4: Qindex MCPサーバーはどのような形式やコンテンツタイプを返しますか？
ツールの応答には、ID、スニペット、タイトル、文書メタデータ、オプションで全文を含む構造化JSONペイロードが含まれ、LLMのコンテキストウィンドウや下流処理に埋め込むのに適しています。

Q5: 接続やサーバーの起動の問題をどのようにトラブルシュートしますか？
AWSの資格情報が設定されていること、地域が正しいこと、IAMポリシーが必要なQ Indexの権限を付与していることを確認してください。MCPクライアントのログ（FASTMCP_LOG_LEVEL=DEBUGを設定）を使用してさらに診断を行います。