MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-12 14:59
태그:
#MCP #AWS #지식베이스 #RAG #Bedrock

링크된 문서

AWS KB Retrieval MCP 서버

AWS KB Retrieval MCP 서버

AWS KB Retrieval MCP 서버는 AWS Bedrock Agent Runtime을 사용하여 AWS Knowledge Base에서 정보를 검색하기 위한 MCP 서버 구현입니다. 이 서버는 자연어 쿼리를 기반으로 관련 콘텐츠를 가져와 LLM에게 제공합니다.

주요 기능

RAG(Retrieval-Augmented Generation)

  • 쿼리와 Knowledge Base ID를 기반으로 AWS Knowledge Base에서 컨텍스트를 검색
  • LLM의 응답을 관련 지식으로 보강하여 정확성과 관련성 향상

여러 결과 검색 지원

  • 사용자 정의 가능한 수의 결과를 검색할 수 있는 옵션
  • 기본적으로 3개의 결과를 반환하지만 필요에 따라 조정 가능

도구

retrieve_from_aws_kb

AWS Knowledge Base를 사용하여 검색 작업을 수행합니다.

입력 매개변수: - query (string): 검색 쿼리 - knowledgeBaseId (string): AWS Knowledge Base의 ID - n (number, 선택 사항): 검색할 결과 수 (기본값: 3)

구성 방법

AWS 자격 증명 설정

  1. AWS Management Console에서 AWS 액세스 키 ID, 비밀 액세스 키 및 리전을 얻습니다.
  2. 이 자격 증명에 Bedrock Agent Runtime 작업에 대한 적절한 권한이 있는지 확인합니다.

Claude Desktop에서 사용하기

Claude Desktop의 claude_desktop_config.json 파일에 다음을 추가합니다:

NPX를 사용한 방법

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-kb-retrieval"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE"
      }
    }
  }
}

Docker를 사용한 방법

{
  "mcpServers": {
    "aws-kb-retrieval": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "-e",
        "AWS_REGION",
        "mcp/aws-kb-retrieval-server"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
        "AWS_REGION": "YOUR_AWS_REGION_HERE"
      }
    }
  }
}

VS Code에서 사용하기

VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. Ctrl + Shift + P를 누르고 Preferences: Open Settings (JSON)을 입력하여 이 작업을 수행할 수 있습니다.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "aws_access_key",
        "description": "AWS Access Key ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_secret_key",
        "description": "AWS Secret Access Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_region",
        "description": "AWS Region"
      }
    ],
    "servers": {
      "aws-kb-retrieval": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-aws-kb-retrieval"
        ],
        "env": {
          "AWS_ACCESS_KEY_ID": "${input:aws_access_key}",
          "AWS_SECRET_ACCESS_KEY": "${input:aws_secret_key}",
          "AWS_REGION": "${input:aws_region}"
        }
      }
    }
  }
}

또는 워크스페이스에서 .vscode/mcp.json이라는 파일에 추가할 수도 있습니다. 이렇게 하면 구성을 다른 사람과 공유할 수 있습니다.

사용 사례

  • 기술 문서 검색: AWS 서비스 관련 기술 문서 및 모범 사례 쿼리
  • 문제 해결 지원: AWS 환경에서 발생하는 일반적인 문제에 대한 해결책 검색
  • 교육 및 학습: AWS 서비스 및 기능에 대한 학습 리소스 제공
  • 의사 결정 지원: AWS 아키텍처 및 솔루션 설계 관련 정보 검색

빌드 방법

Docker를 사용하는 경우: 

docker build -t mcp/aws-kb-retrieval -f src/aws-kb-retrieval-server/Dockerfile .

라이센스

이 MCP 서버는 MIT 라이센스에 따라 라이센스가 부여됩니다. 이는 MIT 라이센스의 이용 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다.

관련 링크