Amazon S3 MCP Server by CData

Amazon S3 MCP 서버(CDATA 기반)

Amazon S3를 위한 CData의 모델 컨텍스트 프로토콜(MCP) 서버

:heavy_exclamation_mark: 이 프로젝트는 읽기 전용 MCP 서버를 구축합니다. 모든 읽기, 쓰기, 업데이트, 삭제 및 작업 기능과 간소화된 설정을 원하시면 무료 [Amazon S3용 CData MCP 서버(베타)]( https://www.cdata.com/download/download.aspx?sku=SXZK-V &type=beta)를 확인해 보세요.

목적

우리는 LLM(예: Claude Desktop)이 Amazon S3 용 CData JDBC 드라이버에서 지원하는 Amazon S3의 라이브 데이터를 쿼리할 수 있도록 이 읽기 전용 MCP 서버를 만들었습니다.

CData JDBC 드라이버는 이를 관계형 SQL 모델로 노출하여 Amazon S3에 연결합니다.

이 서버는 드라이버를 래핑하고 간단한 MCP 인터페이스를 통해 Amazon S3 데이터를 제공하므로 LLM은 SQL이 필요 없이 자연어 질문을 통해 실시간 정보를 검색할 수 있습니다.

설정 가이드

1. 저장소를 복제합니다.지엑스피1
2. 서버를 빌드하세요:
   mvn clean install
   이렇게 하면 JAR 파일이 생성됩니다: CDataMCP-jar-with-dependencies.jar
3. {source}에 대한 CData JDBC 드라이버를 다운로드하고 설치하세요: https://www.cdata.com/drivers/amazons3/download/jdbc
4. CData JDBC 드라이버 라이선스:
   • 설치 디렉토리의 lib 폴더로 이동합니다. 일반적으로 다음과 같습니다.
     • (Windows) C:\Program Files\CData\CData JDBC Driver for Amazon S3\
     • (Mac/Linux) /Applications/CData JDBC Driver for Amazon S3/
   • java -jar cdata.jdbc.amazons3.jar --license 명령을 실행합니다.
   • 이름, 이메일, "TRAIAL"(또는 라이선스 키)을 입력하세요.
5. 데이터 소스(예: Salesforce)에 대한 연결을 구성합니다.
   • 연결 문자열 유틸리티를 열려면 java -jar cdata.jdbc.amazons3.jar 명령을 실행하세요.
   • 연결 문자열을 구성하고 "연결 테스트"를 클릭하세요.

     참고: 데이터 소스가 OAuth를 사용하는 경우 브라우저에서 인증해야 합니다.

   • 성공하면 나중에 사용할 수 있도록 연결 문자열을 복사합니다.
6. 다음 속성과 형식을 사용하여 JDBC 연결에 대한 .prp 파일(예: amazon-s3.prp )을 만듭니다.
   • 접두사 - 노출된 도구에 사용할 접두사
   • ServerName - 서버의 이름
   • ServerVersion - 서버 버전
   • DriverPath - JDBC 드라이버의 JAR 파일에 대한 전체 경로
   • DriverClass - JDBC 드라이버 클래스의 이름(예: cdata.jdbc.amazons3.AmazonS3Driver)
   • JdbcUrl - CData JDBC 드라이버와 함께 사용하여 데이터에 연결할 JDBC 연결 문자열(위에서 복사)
   • 테이블 - 모든 데이터에 액세스하려면 비워두세요. 그렇지 않으면 액세스를 생성하려는 테이블을 명시적으로 선언할 수 있습니다.
     Prefix=amazons3 ServerName=CDataAmazonS3 ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.amazons3.jar DriverClass=cdata.jdbc.amazons3.AmazonS3Driver JdbcUrl=jdbc:amazons3:InitiateOAuth=GETANDREFRESH; Tables=

Claude Desktop과 함께 서버 사용

1. 아래 형식을 사용하여 Claude Desktop용 구성 파일(claude_desktop_config.json)을 생성하여 새 MCP 서버를 추가하세요. 파일이 이미 있는 경우 구성 파일의 mcpServers 항목에 해당 항목을 추가하세요.윈도우
   { "mcpServers": { "{classname_dash}": { "command": "PATH\\TO\\java.exe", "args": [ "-jar", "PATH\\TO\\CDataMCP-jar-with-dependencies.jar", "PATH\\TO\\amazon-s3.prp" ] }, ... } }
   리눅스/맥
   { "mcpServers": { "{classname_dash}": { "command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/amazon-s3.prp" ] }, ... } }
   필요한 경우 구성 파일을 적절한 디렉토리(예: Claude Desktop)에 복사합니다. Windows
   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
   리눅스/맥
   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'
2. 클라이언트(Claude Desktop)를 실행하거나 새로 고칩니다.

참고: MCP 서버를 나타나게 하려면 Claude Desktop 클라이언트를 완전히 종료하거나 종료한 후 다시 열어야 할 수도 있습니다.

서버 실행

1. 다음 명령을 실행하여 MCP 서버를 자체적으로 실행하세요.
   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

참고: 서버는 stdio 사용하므로 서버와 동일한 컴퓨터에서 실행되는 클라이언트에서만 사용할 수 있습니다.

사용 세부 정보

MCP 서버가 구성되면 AI 클라이언트는 내장 도구를 사용하여 기본 데이터를 읽고, 쓰고, 업데이트하고, 삭제할 수 있습니다. 일반적으로 도구를 명시적으로 호출할 필요는 없습니다. 클라이언트에게 기본 데이터 시스템에 대한 질문에 답변해 달라고 요청하기만 하면 됩니다. 예를 들면 다음과 같습니다.

• "내가 성사시킨 수익 기회와 계정 산업 간의 상관관계는 무엇입니까?"
• "SUPPORT 프로젝트에는 몇 개의 오픈 티켓이 있나요?"
• "오늘 일정에 어떤 일정이 있는지 알려주시겠어요?"

사용 가능한 도구 목록과 설명은 다음과 같습니다.

도구 및 설명

아래 정의에서 {servername} 구성 파일의 MCP 서버 이름을 나타냅니다(예: 위의 {classname_dash} ).

• {servername}_get_tables - 데이터 소스에서 사용 가능한 테이블 목록을 가져옵니다. {servername}_get_columns 도구를 사용하여 테이블에서 사용 가능한 열을 나열할 수 있습니다. 도구의 출력은 CSV 형식으로 반환되며, 첫 번째 줄에는 열 헤더가 포함됩니다.
• {servername}_get_columns - 테이블의 열 목록을 가져옵니다. {servername}_get_tables 도구를 사용하여 사용 가능한 테이블 목록을 가져옵니다. 도구의 출력은 CSV 형식으로 반환되며, 첫 번째 줄에는 열 헤더가 포함됩니다.
• {servername}_run_query - SQL SELECT 쿼리 실행

문제 해결

1. Claude Desktop에서 CData MCP 서버를 볼 수 없는 경우 Claude Desktop을 완전히 종료했는지 확인하세요(Windows: 작업 관리자 사용, Mac: 활동 모니터 사용).
2. Claude Desktop에서 데이터를 가져올 수 없는 경우, 연결이 제대로 구성되었는지 확인하세요. 연결 문자열 빌더를 사용하여 연결 문자열(위 참조)을 생성하고 속성(.prp) 파일에 복사하세요.
3. 데이터 소스에 연결하는 데 문제가 있는 경우 CData 지원팀 에 문의하세요.
4. MCP 서버를 사용하는 데 문제가 있거나 다른 피드백이 있는 경우 CData 커뮤니티 에 가입하세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

지원되는 모든 소스