hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Microsoft SQL Server MCP 서버

Microsoft SQL Server 데이터베이스와의 안전한 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서가 제어된 인터페이스를 통해 테이블 목록을 작성하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있으므로 데이터베이스 탐색 및 분석이 더욱 안전하고 체계적으로 이루어집니다.

특징

사용 가능한 SQL Server 테이블을 리소스로 나열합니다.
표의 내용을 읽어보세요
적절한 오류 처리를 통해 SQL 쿼리 실행
환경 변수를 통한 안전한 데이터베이스 액세스
종합 로깅
자동 시스템 종속성 설치

설치

MCP를 통해 설치하면 패키지는 필요한 시스템 종속성(예: FreeTDS)을 자동으로 설치합니다.

지엑스피1

구성

다음 환경 변수를 설정하세요.

MSSQL_SERVER=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database

용법

클로드 데스크톱과 함께

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "mssql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mssql_mcp_server",
        "run",
        "mssql_mcp_server"
      ],
      "env": {
        "MSSQL_SERVER": "localhost",
        "MSSQL_USER": "your_username",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database"
      }
    }
  }
}

독립형 서버로서

# Install dependencies
pip install -r requirements.txt

# Run the server
python -m mssql_mcp_server

개발

# Clone the repository
git clone https://github.com/RichardHan/mssql_mcp_server.git
cd mssql_mcp_server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

보안 고려 사항

환경 변수나 자격 증명을 커밋하지 마십시오.
최소한의 필수 권한이 있는 데이터베이스 사용자를 사용하세요
프로덕션 사용을 위해 쿼리 허용 목록을 구현하는 것을 고려하세요.
모든 데이터베이스 작업을 모니터링하고 기록합니다.

보안 모범 사례

이 MCP 서버가 작동하려면 데이터베이스 액세스가 필요합니다. 보안을 위해:

최소한의 권한으로 전용 SQL Server 로그인을 만듭니다.
SA 자격 증명이나 관리 계정을 사용하지 마십시오.
필요한 작업에만 데이터베이스 액세스를 제한합니다.
감사 목적으로 로깅을 활성화합니다 .
데이터베이스 접근에 대한 정기적인 보안 검토

자세한 지침은 SQL Server 보안 구성 가이드를 참조하세요.

제한된 SQL Server 로그인 만들기
적절한 권한 설정
데이터베이스 액세스 모니터링
보안 모범 사례

⚠️ 중요: 데이터베이스 액세스를 구성할 때는 항상 최소 권한 원칙을 따르세요.

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

execute_sql

Microsoft SQL Server 데이터베이스와의 안전한 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, AI 보조자가 제어된 인터페이스를 통해 테이블을 나열하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있도록 해줍니다.

Related Resources

Reddit Discussion about this server

Microsoft SQL Server MCP Server