MSSQL MCP 서버
Microsoft SQL Server 데이터베이스에 연결하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 SQL 쿼리 실행 및 데이터베이스 연결 관리 도구를 제공합니다.
버전 알림: 이 프로젝트는 Model Context Protocol SDK 1.9.0을 사용하도록 업그레이드되었습니다. 자세한 내용은 UPGRADE.md를 참조하세요.
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 MSSQL MCP 서버를 자동으로 설치하려면:
지엑스피1
수동 설치
npm install mssql-mcp-serverRelated MCP server: MySQL-MCP
용법
MCP 설정 구성 파일에 서버를 추가합니다.
{
"mcpServers": {
"mssql": {
"command": "mssql-mcp-server",
"env": {
"MSSQL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=yourpassword;",
// Or individual connection parameters:
"MSSQL_HOST": "localhost",
"MSSQL_PORT": "1433",
"MSSQL_DATABASE": "master",
"MSSQL_USER": "sa",
"MSSQL_PASSWORD": "yourpassword",
"MSSQL_ENCRYPT": "false",
"MSSQL_TRUST_SERVER_CERTIFICATE": "true"
}
}
}
}도구
질문
MSSQL 데이터베이스에서 SQL 쿼리를 실행합니다.
매개변수
connectionString(문자열, 선택 사항): 전체 연결 문자열(개별 매개변수에 대한 대안)host(문자열, 선택 사항): 데이터베이스 서버 호스트 이름port(숫자, 선택): 데이터베이스 서버 포트(기본값: 1433)database(문자열, 선택 사항): 데이터베이스 이름(기본값: master)username(문자열, 선택 사항): 데이터베이스 사용자 이름password(문자열, 선택 사항): 데이터베이스 비밀번호query(문자열, 필수): 실행할 SQL 쿼리encrypt(부울, 선택 사항): 암호화를 활성화합니다(기본값: false)trustServerCertificate(부울, 선택 사항): 신뢰 서버 인증서(기본값: true)
connectionString 또는 ( host + username + password )를 제공해야 합니다.
예
const result = await use_mcp_tool({
server_name: 'mssql',
tool_name: 'query',
arguments: {
host: 'localhost',
username: 'sa',
password: 'yourpassword',
query: 'SELECT * FROM Users',
},
});서버 실행
지역 개발
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build
npm run build
# Run the built server
npm startDocker 사용
# Build and start services (SQL Server + MCP server)
docker-compose up
# Or just build the Docker image
docker build -t mssql-mcp-server .테스트
# Run tests
npm test
# Run tests with coverage
npm run test:coverage보안
서버에는 위험한 SQL 작업에 대한 보호 장치가 포함되어 있습니다.
DROP, TRUNCATE, ALTER, CREATE, EXEC 등과 같이 잠재적으로 유해한 명령을 차단합니다.
모든 입력 매개변수와 데이터베이스 이름을 검증합니다.
쿼리 길이와 시간 초과에 대한 합리적인 제한을 설정합니다.
더 나은 성능과 보안을 위해 연결 풀링을 사용합니다.
특허
MIT