MCP 데이터베이스 서버

이 MCP(Model Context Protocol) 서버는 Claude에 데이터베이스 액세스 기능을 제공하며 SQLite, SQL Server, PostgreSQL 데이터베이스를 지원합니다.

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

Related MCP server: SQLite MCP Server

사용 옵션

Claude와 함께 이 MCP 서버를 사용하는 방법은 두 가지가 있습니다.

직접 사용 : 패키지를 전역으로 설치하고 직접 사용하세요
로컬 개발 : 로컬 개발 환경에서 실행

NPM 패키지로 직접 사용

이 MCP 서버를 사용하는 가장 쉬운 방법은 전역적으로 설치하는 것입니다.

npm install -g @executeautomation/database-server

이를 통해 로컬에 서버를 구축하지 않고도 직접 서버를 사용할 수 있습니다.

지역 개발 설정

코드를 수정하거나 로컬 환경에서 실행하려면 다음을 수행하세요.

설치 섹션에 표시된 대로 저장소를 복제하고 빌드합니다.
아래 사용법 섹션의 명령을 사용하여 서버를 실행하세요.

용법

SQLite 데이터베이스

SQLite 데이터베이스와 함께 사용하려면:

node dist/src/index.js /path/to/your/database.db

SQL 서버 데이터베이스

SQL Server 데이터베이스와 함께 사용하려면:

node dist/src/index.js --sqlserver --server <server-name> --database <database-name> [--user <username> --password <password>]

필수 매개변수:

--server : SQL Server 호스트 이름 또는 IP 주소
--database : 데이터베이스 이름

선택 매개변수:

--user : SQL Server 인증을 위한 사용자 이름(제공되지 않으면 Windows 인증이 사용됨)
--password : SQL Server 인증을 위한 비밀번호
--port : 포트 번호 (기본값: 1433)

PostgreSQL 데이터베이스

PostgreSQL 데이터베이스와 함께 사용하려면:

node dist/src/index.js --postgresql --host <host-name> --database <database-name> [--user <username> --password <password>]

필수 매개변수:

--host : PostgreSQL 호스트 이름 또는 IP 주소
--database : 데이터베이스 이름

선택 매개변수:

--user : PostgreSQL 인증을 위한 사용자 이름
--password : PostgreSQL 인증을 위한 비밀번호
--port : 포트 번호(기본값: 5432)
--ssl : SSL 연결 활성화 (true/false)
--connection-timeout : 연결 시간 초과(밀리초) (기본값: 30000)

Claude Desktop 구성

직접 사용 구성

패키지를 글로벌하게 설치한 경우, 다음을 사용하여 Claude Desktop을 구성하세요.

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    }
  }
}

로컬 개발 구성

로컬 개발의 경우 로컬로 빌드한 버전을 사용하도록 Claude Desktop을 구성하세요.

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js", 
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    }
  }
}

Claude Desktop 구성 파일은 일반적으로 다음 위치에 있습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
리눅스: ~/.config/Claude/claude_desktop_config.json

사용 가능한 데이터베이스 도구

MCP 데이터베이스 서버는 Claude가 사용할 수 있는 다음과 같은 도구를 제공합니다.

도구	설명	필수 매개변수
`read_query`	SELECT 쿼리를 실행하여 데이터를 읽습니다.	`query` : SQL SELECT 문
`write_query`	INSERT, UPDATE 또는 DELETE 쿼리 실행	`query` : SQL 수정 명령문
`create_table`	데이터베이스에 새 테이블을 만듭니다	`query` : CREATE TABLE 문
`alter_table`	기존 테이블 스키마 수정	`query` : ALTER TABLE 문
`drop_table`	데이터베이스에서 테이블 제거	`table_name` : 테이블 이름, `confirm` : 안전 플래그(반드시 참이어야 함)
`list_tables`	모든 테이블 목록 가져오기	없음
`describe_table`	테이블에 대한 스키마 정보 보기	`table_name` : 테이블 이름
`export_query`	쿼리 결과를 CSV/JSON으로 내보내기	`query` : SQL SELECT 문 `format` : "csv" 또는 "json"
`append_insight`	메모에 비즈니스 통찰력 추가	`insight` : 통찰력의 텍스트
`list_insights`	모든 비즈니스 통찰력을 나열하세요	없음

Claude와 함께 이러한 도구를 사용하는 방법에 대한 실제적인 예는 사용 예를 참조하세요.

추가 문서

SQL Server 설치 가이드 : SQL Server 데이터베이스 연결에 대한 세부 정보
PostgreSQL 설정 가이드 : PostgreSQL 데이터베이스 연결에 대한 세부 정보
사용 예 : Claude와 함께 사용할 수 있는 예제 쿼리 및 명령

개발

개발 모드에서 서버를 실행하려면:

npm run dev

개발 중 변화를 살펴보려면:

npm run watch

요구 사항

노드.js 18+
SQL Server 연결의 경우: SQL Server 2012 이상
PostgreSQL 연결의 경우: PostgreSQL 9.5 이상

특허

MIT

ExecuteAutomation Database Server