MCP 데이터베이스 서버

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

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

npm install

3. 프로젝트를 빌드하세요:

npm run build

Related MCP server: MCP TapData Server

사용 옵션

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

1. 직접 사용 : 패키지를 전역으로 설치하고 직접 사용하세요

2. 로컬 개발 : 로컬 개발 환경에서 실행

NPM 패키지로 직접 사용

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

npm install -g @executeautomation/database-server

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

지역 개발 설정

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

1. 설치 섹션에 표시된 대로 저장소를 복제하고 빌드합니다.

2. 아래 사용법 섹션의 명령을 사용하여 서버를 실행하세요.

용법

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가 사용할 수 있는 다음과 같은 도구를 제공합니다.

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers