db-mcp-tool

데이터베이스 탐색기 MCP 도구

PostgreSQL, MySQL, Firestore를 포함한 다양한 유형의 데이터베이스를 탐색하고 관리하기 위한 강력한 모델 컨텍스트 프로토콜(MCP) 도구입니다.

특징

• 다중 데이터베이스 지원
  • 포스트그레스큐엘
  • MySQL
  • 파이어스토어
• 데이터베이스 작업
  • 데이터베이스에 연결
  • 테이블 목록
  • 트리거 보기
  • 목록 함수
  • SQL 쿼리 실행(PostgreSQL 및 MySQL)
  • 테이블 스키마 내보내기
  • 테이블 데이터 내보내기

커서와의 통합

커서에 도구를 추가하기 전에 프로젝트를 빌드해야 합니다.

1. 저장소를 복제합니다
2. 종속성 설치:지엑스피1
3. 프로젝트를 빌드하세요:
   npm run build

커서에 도구를 추가하려면:

1. 커서 설정 열기
2. "모델 컨텍스트 프로토콜(MCP)" 섹션으로 이동합니다.
3. "새 도구 추가"를 클릭하세요
4. 다음 세부 정보를 입력하세요.
   { "name": "database-explorer", "command": "node /path/to/project/dist/index.js", "description": "Database Explorer MCP Tool" }
   참고: /path/to/project 프로젝트 디렉토리의 실제 경로로 바꾸세요.
5. 설정을 저장하세요
6. 커서 재시작

도구 사용:

1. 설정 후 다음 명령 중 하나를 사용하여 데이터베이스에 연결할 수 있습니다.
   • PostgreSQL의 경우: 연결 세부 정보와 함께 !pg 사용하세요.
   • MySQL의 경우: 연결 세부 정보와 함께 !mysql 사용하세요.
   • Firestore의 경우: 연결 세부 정보와 함께 !firestore 사용하세요.
2. 연결되면 다양한 데이터베이스 작업을 사용할 수 있습니다.
   • !tables 사용하여 모든 테이블을 나열합니다.
   • 트리거를 보려면 !triggers 사용하세요.
   • !functions 를 나열합니다
   • !query 사용하여 SQL 쿼리를 실행합니다.
   • !export-db 사용하여 테이블 스키마를 내보냅니다.
   • !export-data 사용하여 테이블 데이터를 내보냅니다.

자세한 사용 예는 아래의 명령 섹션을 참조하세요.

명령

연결 명령

• !pg - PostgreSQL 데이터베이스에 연결
  { "connection": { "host": "hostname", "port": 5432, "database": "dbname", "user": "username", "password": "password" } }
• !mysql - MySQL 데이터베이스에 연결
  { "connection": { "host": "hostname", "port": 3306, "database": "dbname", "user": "username", "password": "password" } }
• !firestore - Firestore 데이터베이스에 연결
  { "connection": { "projectId": "your-project-id", "keyFilename": "path/to/keyfile.json" } }

데이터베이스 작업 명령

• !tables - 연결된 데이터베이스의 모든 테이블을 나열합니다.
• !triggers - 연결된 데이터베이스의 모든 트리거를 나열합니다.
• !functions - 연결된 데이터베이스의 모든 함수를 나열합니다.
• !query - SQL 쿼리 실행(PostgreSQL 및 MySQL만 해당)
  { "query": "SELECT * FROM table_name" }
• !export-db - 테이블 스키마 내보내기
  { "table": "table_name" }
• !export-data - 테이블 데이터를 INSERT 문으로 내보내기
  { "table": "table_name" }

요구 사항

• 노드.js
• 필요한 데이터베이스 드라이버:
  • PostgreSQL용 pg
  • MySQL용 mysql2
  • Firestore의 경우 @google-cloud/firestore

용법

1. 필요한 데이터베이스 자격 증명이 있는지 확인하세요
2. 적절한 연결 명령을 사용하여 데이터베이스에 연결하세요.
3. 사용 가능한 명령을 사용하여 데이터베이스를 탐색하고 관리하세요.

오류 처리

• 이 도구에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.
  • 연결 실패
  • 쿼리 실행 오류
  • 스키마 및 데이터 내보내기 문제
  • 잘못된 데이터베이스 작업

노트

• Firestore 지원은 NoSQL 특성으로 인해 기본 작업에만 제한됩니다.
• SQL 작업은 PostgreSQL 및 MySQL에서만 사용할 수 있습니다.