mssql-mcp

mssql 드라이버를 사용하여 Microsoft SQL Server에 연결하는 MCP 서버(stdio)입니다. 도구 인수는 Valibot으로 정의 및 검증되며, 클라이언트를 위한 JSON 스키마는 @valibot/to-json-schema를 사용하여 생성됩니다.

구현 참고: 이 프로젝트는 현재 SDK의 McpServer.registerTool 경로가 스키마 내보내기 및 검증을 위해 Zod를 중심으로 구축되어 있기 때문에 McpServer 대신 저수준 @modelcontextprotocol/sdk Server 클래스를 사용합니다. 도구는 ListTools / tools/call 핸들러와 핸들러 내부의 Valibot 파싱을 통해 등록됩니다.

도구

• mssql_query — T-SQL 배치를 실행합니다. recordsets 및 rowsAffected를 반환합니다. 설정된 경우 SET ROWCOUNT를 통해 MSSQL_MAX_ROWS를 준수합니다.

• mssql_list_tables — INFORMATION_SCHEMA.TABLES에서 기본 테이블을 가져오며, 선택적으로 스키마 필터를 사용할 수 있습니다.

• mssql_describe_table — INFORMATION_SCHEMA.COLUMNS에서 열 메타데이터를 가져옵니다.

환경 변수

.env.example을 참조하세요. 필수 항목: MSSQL_SERVER, MSSQL_USER, MSSQL_PASSWORD, MSSQL_DATABASE.

• MSSQL_ALLOW_WRITES — 기본값은 꺼짐입니다. 꺼져 있을 때, 일반적인 쓰기/DDL/exec 키워드를 차단하는 휴리스틱이 작동합니다(데이터베이스 권한을 대체하지는 않습니다).

• MSSQL_MAX_ROWS — 설정된 경우, mssql_query에 대해 배치를 SET ROWCOUNT로 감쌉니다.

• MSSQL_ENCRYPT / MSSQL_TRUST_SERVER_CERTIFICATE — 드라이버로 전달됩니다(encrypt는 기본적으로 true).

빌드 및 실행

pnpm install
pnpm run build
pnpm start

개발(별도 빌드 없음):

pnpm dev

MCP 하에서 실행할 때는 stdout에 로그를 기록하지 마십시오. 프로토콜이 stdout을 사용하기 때문입니다. 시작 시 발생하는 오류는 console.error를 통해 stderr로 출력됩니다.

Cursor MCP 구성

체크아웃한 절대 경로를 사용하세요. 예시 사용자 MCP 구성 조각:

{
  "mcpServers": {
    "mssql": {
      "command": "node",
      "args": ["/home/adrian/code/mcp/dist/index.js"],
      "env": {
        "MSSQL_SERVER": "localhost",
        "MSSQL_USER": "your_user",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

(위와 같이) command로 node를 사용하세요. command를 pnpm이나 npx로 설정하지 마십시오. pnpm이 실패하거나 stdout에 출력하면, stdout은 JSON-RPC 전용이어야 하므로 Cursor가 Unexpected token … "ERR_PNPM_"… is not valid JSON과 같은 오류를 표시합니다.

빌드 없는 개발 모드 (여전히 node 사용)

node가 node_modules에서 tsx를 찾을 수 있도록 **cwd**를 이 저장소로 설정하세요:

{
  "mcpServers": {
    "mssql": {
      "command": "node",
      "args": ["--import", "tsx", "/home/adrian/code/mcp/src/index.ts"],
      "cwd": "/home/adrian/code/mcp",
      "env": { }
    }
  }
}

위 예시와 동일하게 env를 채우세요. tsx가 존재하도록 먼저 로컬에서 pnpm install을 실행하세요.