AWS Bedrock KB Retrieval

Amazon Bedrock Bilgi Tabanı Erişim MCP Sunucusu

Amazon Bedrock Bilgi Tabanlarına erişim için MCP sunucusu

Özellikler

Bilgi tabanlarını ve veri kaynaklarını keşfedin

• Mevcut tüm bilgi tabanlarını bulun ve keşfedin
• Bilgi tabanlarını ada veya etikete göre arayın
• Her bilgi tabanıyla ilişkili veri kaynaklarını listeleyin

Bilgi tabanlarını doğal dille sorgulayın

• Konuşma dilindeki sorgularla bilgi alın
• Bilgi tabanlarınızdan ilgili pasajları edinin
• Tüm sonuçlar için alıntı bilgilerine erişin

Sonuçları veri kaynağına göre filtreleyin

• Sorgularınızı belirli veri kaynaklarına odaklayın
• Belirli veri kaynaklarını dahil edin veya hariç tutun
• Belirli veri kaynaklarından gelen sonuçlara öncelik verin

Sonuçları yeniden sıralayın

• Erişim sonuçlarının alaka düzeyini iyileştirin
• Amazon Bedrock yeniden sıralama yeteneklerini kullanın
• Sonuçları sorgunuzla alaka düzeyine göre sıralayın

Ön Koşullar

Kurulum Gereksinimleri

1. uv'ı Astral veya GitHub README üzerinden yükleyin
2. Python'u uv python install 3.10 kullanarak yükleyin

AWS Gereksinimleri

1. AWS CLI Yapılandırması: AWS CLI'nin kimlik bilgileri ve Amazon Bedrock ile Bilgi Tabanlarına erişimi olan bir AWS_PROFILE ile yapılandırılmış olması gerekir
2. Amazon Bedrock Bilgi Tabanı: mcp-multirag-kb etiket anahtarına ve true değerine sahip en az bir Amazon Bedrock Bilgi Tabanınız olmalıdır
3. IAM İzinleri: IAM rolünüzün/kullanıcınızın aşağıdakiler için uygun izinlere sahip olması gerekir:
   • Bilgi tabanlarını listeleme ve tanımlama
   • Veri kaynaklarına erişme
   • Bilgi tabanlarını sorgulama

Yeniden Sıralama Gereksinimleri

Yeniden sıralama işlevini kullanmayı düşünüyorsanız, Bedrock Bilgi Tabanınızın ek izinlere ihtiyacı vardır:

1. IAM rolünüz hem bedrock:Rerank hem de bedrock:InvokeModel eylemleri için izinlere sahip olmalıdır
2. Amazon Bedrock Bilgi Tabanları hizmet rolü de bu izinlere sahip olmalıdır
3. Yeniden sıralama yalnızca belirli bölgelerde kullanılabilir. Desteklenen bölgelerin güncel listesi için resmi belgelere bakın.
4. Belirtilen bölgede mevcut yeniden sıralama modelleri için model erişimini etkinleştirin.

Yeniden Sıralamayı Kontrol Etme

Yeniden sıralama, BEDROCK_KB_RERANKING_ENABLED ortam değişkeni kullanılarak genel olarak etkinleştirilebilir veya devre dışı bırakılabilir:

• false olarak ayarlayın (varsayılan): Açıkça etkinleştirilmediği sürece tüm sorgular için yeniden sıralamayı devre dışı bırakır
• true olarak ayarlayın: Açıkça devre dışı bırakılmadığı sürece tüm sorgular için yeniden sıralamayı etkinleştirir

Ortam değişkeni çeşitli biçimleri kabul eder:

• Etkinleştirmek için: 'true', '1', 'yes' veya 'on' (büyük/küçük harf duyarsız)
• Devre dışı bırakmak için: diğer herhangi bir değer veya ayarlanmamış (varsayılan davranış)

Bu ayar genel bir varsayılan sağlarken, bireysel API çağrıları reranking parametresini açıkça ayarlayarak bunu geçersiz kılabilir.

Bilgi tabanlarını kurmayla ilgili ayrıntılı talimatlar için bkz:

• Bilgi tabanı oluşturma
• Amazon Bedrock bilgi tabanları için izinleri yönetme
• Amazon Bedrock'ta yeniden sıralama için izinler

Kurulum

Kiro	Cursor	VS Code

MCP sunucusunu MCP istemci yapılandırmanızda yapılandırın (örneğin, Kiro için ~/.kiro/settings/mcp.json dosyasını düzenleyin):

{
  "mcpServers": {
    "awslabs.bedrock-kb-retrieval-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.bedrock-kb-retrieval-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-profile-name",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR",
        "KB_INCLUSION_TAG_KEY": "optional-tag-key-to-filter-kbs",
        "BEDROCK_KB_RERANKING_ENABLED": "false"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows Kurulumu

Windows kullanıcıları için MCP sunucu yapılandırma biçimi biraz farklıdır:

{
  "mcpServers": {
    "awslabs.bedrock-kb-retrieval-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.bedrock-kb-retrieval-mcp-server@latest",
        "awslabs.bedrock-kb-retrieval-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

veya başarılı bir docker build -t awslabs/bedrock-kb-retrieval-mcp-server . sonrasında docker:

# fictitious `.env` file with AWS temporary credentials
AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

  {
    "mcpServers": {
      "awslabs.bedrock-kb-retrieval-mcp-server": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "--interactive",
          "--env",
          "FASTMCP_LOG_LEVEL=ERROR",
          "--env",
          "KB_INCLUSION_TAG_KEY=optional-tag-key-to-filter-kbs",
          "--env",
          "BEDROCK_KB_RERANKING_ENABLED=false",
          "--env",
          "AWS_REGION=us-east-1",
          "--env-file",
          "/full/path/to/file/above/.env",
          "awslabs/bedrock-kb-retrieval-mcp-server:latest"
        ],
        "env": {},
        "disabled": false,
        "autoApprove": []
      }
    }
  }

NOT: Kimlik bilgilerinizin ana makinenizden düzenli olarak yenilenmesi gerekecektir

Sınırlamalar

• IMAGE içerik türüne sahip sonuçlar KB sorgu yanıtına dahil edilmez.
• reranking parametresi ek izinler, Amazon Bedrock model erişimi gerektirir ve yalnızca belirli bölgelerde kullanılabilir.