MSSQL MCP Server

MIT License
12
  • Linux
  • Apple

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Features CI/CD integration through GitHub Actions for automated testing as indicated by the tests workflow badge

MSSQL MCP 서버

MSSQL MCP 서버는 Microsoft SQL Server(MSSQL) 데이터베이스와의 안전하고 체계적인 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버 입니다. AI 비서가 다음과 같은 작업을 수행할 수 있도록 지원합니다.

  • 사용 가능한 테이블 나열
  • 표의 내용을 읽어보세요
  • 제어된 액세스로 SQL 쿼리 실행

이를 통해 보다 안전한 데이터베이스 탐색, 엄격한 권한 적용, 데이터베이스 상호작용 로깅이 보장됩니다.

특징

  • 환경 변수를 통한 MSSQL 데이터베이스 액세스 보안
  • 오류 처리를 통한 제어된 쿼리 실행
  • 테이블 목록 및 데이터 검색
  • 쿼리 및 작업 모니터링을 위한 포괄적인 로깅

설치

지엑스피1

구성

데이터베이스 액세스를 구성하려면 다음 환경 변수를 설정하세요.

MSSQL_DRIVER=mssql_driver MSSQL_HOST=localhost MSSQL_USER=your_username MSSQL_PASSWORD=your_password MSSQL_DATABASE=your_database #optional TrustServerCertificate=yes Trusted_Connection=no

용법

Claude Desktop과 함께

Claude Desktop 과 통합하려면 claude_desktop_config.json 에 다음 구성을 추가하세요.

{ "mcpServers": { "mssql": { "command": "uv", "args": [ "--directory", "path/to/mssql_mcp_server", "run", "mssql_mcp_server" ], "env": { "MSSQL_DRIVER": "mssql_driver", "MSSQL_HOST": "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/yourusername/mssql_mcp_server.git cd mssql_mcp_server # Set up a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install development dependencies pip install -r requirements-dev.txt # Run tests pytest

보안 고려 사항

  • 최소한의 권한을 가진 전담 MSSQL 사용자를 사용하세요 .
  • 루트 자격 증명이나 전체 관리 계정을 사용하지 마십시오 .
  • 필요한 작업에만 데이터베이스 액세스를 제한합니다 .
  • 보안 모니터링을 위해 로깅과 감사를 활성화합니다 .
  • 최소한의 권한으로 액세스하도록 권한을 정기적으로 검토하세요 .

보안 모범 사례

안전한 설정을 위해:

  1. 권한이 제한된 전담 MSSQL 사용자를 만듭니다 .
  2. 자격 증명을 하드코딩하지 말고 대신 환경 변수를 사용하세요.
  3. 필요한 테이블과 작업에만 접근을 제한합니다 .
  4. 감사를 위해 SQL Server 로깅 및 모니터링을 활성화합니다 .
  5. 정기적으로 데이터베이스 접근을 검토하여 무단 접근을 방지하세요.

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

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

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여하다

여러분의 참여를 환영합니다! 참여 방법:

  1. 저장소를 포크합니다.
  2. 기능 브랜치를 생성합니다: git checkout -b feature/amazing-feature
  3. 변경 사항을 커밋하세요: git commit -m 'Add amazing feature'
  4. 브랜치에 푸시: git push origin feature/amazing-feature
  5. 풀 리퀘스트를 엽니다.

도움이 필요하신가요?

질문이나 문제가 있는 경우, GitHub Issue를 개설하거나 관리자에게 문의하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

Microsoft SQL Server 데이터베이스와의 안전하고 체계적인 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, AI 어시스턴트가 제어된 접근 방식으로 테이블을 나열하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있도록 해줍니다.

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. With Claude Desktop
          2. Running as a Standalone Server
        2. Development
          1. Security Considerations
            1. Security Best Practices
              1. License
                1. Contributing
                  1. Need Help?
                ID: jfvvxr08az