1. 왜 Cursor와 MSSQL을 연결해야 하는가?
주니어 개발자가 가장 많이 하는 작업은 다음과 같습니다.
SSMS 실행
↓
테이블 찾기
↓
컬럼 확인
↓
복사
↓
Cursor 붙여넣기
↓
AI 질문
↓
다시 SSMS
생각보다 이 작업을 하루에도 수십 번 반복합니다.
특히 프로젝트가 커질수록
- 수백 개의 테이블
- 수천 개의 컬럼
- 수많은 FK 관계
를 AI에게 매번 설명해야 합니다.
반면 MCP를 연결하면 Cursor AI가 직접 데이터베이스를 읽을 수 있으므로 이러한 반복 작업이 거의 사라집니다.
즉,
AI가 실제 데이터베이스를 이해한 상태에서 코드를 생성하는 환경을 만드는 것이 이번 글의 목표입니다.
2. Extension과 MCP의 차이를 먼저 이해하자
많은 사람들이 이 둘을 헷갈립니다.
| 기능 |
SQL Server Extension |
MCP |
| 사람이 사용 |
O |
X |
| AI가 사용 |
X |
O |
| SELECT 실행 |
O |
O |
| 테이블 탐색 |
O |
O |
| AI 자동 스키마 분석 |
X |
O |
| Entity 생성 |
X |
O |
| Repository 생성 |
X |
O |
즉,
Extension은
사람이 보는 도구
MCP는
AI가 사용하는 도구
입니다.
둘은 경쟁 관계가 아니라 함께 사용하는 것이 가장 좋습니다.
3. SQL Server Extension 설치
먼저 사람이 직접 DB를 확인할 수 있도록 Extension을 설치합니다.
Ctrl + Shift + X
검색
SQL Server (mssql)
Microsoft에서 제공하는 공식 Extension을 설치합니다.
설치가 완료되면 좌측 Activity Bar에 Database 아이콘이 추가됩니다.
여기서 새로운 Connection을 생성합니다.
예시
Server
localhost
Authentication
SQL Login
User
sa
Password
********
Database
SampleDB
연결이 완료되면
- Tables
- Views
- Stored Procedures
- Functions
등을 Cursor 내부에서 바로 탐색할 수 있습니다.
이제 SSMS를 열지 않아도 대부분의 조회 작업이 가능합니다.
4. 이제 AI가 DB를 읽을 차례이다
여기서부터가 MCP입니다.
Extension은 사람이 사용합니다.
하지만 AI는 Extension을 읽지 못합니다.
그래서
AI
↓
MCP
↓
SQL Server
라는 통로를 만들어야 합니다.
5. Python 설치
많은 주니어가 여기서 막힙니다.
먼저 Python이 설치되어 있어야 합니다.
PowerShell에서 확인합니다.
python --version
또는
py --version
버전이 출력되지 않는다면 Python을 먼저 설치해야 합니다.
6. MSSQL MCP 설치
PowerShell 실행
python -m pip install mssql_mcp_server
또는
py -m pip install mssql_mcp_server
설치 확인
python -m mssql_mcp_server --help
정상이라면 도움말이 출력됩니다.
7. Cursor에 MCP 등록
Cursor
Settings
↓
MCP
또는
.cursor/mcp.json
프로젝트에 등록합니다.
예시
{
"mcpServers": {
"mssql": {
"command": "python",
"args": [
"-m",
"mssql_mcp_server"
],
"env": {
"DB_SERVER": "localhost",
"DB_NAME": "SampleDB",
"DB_USER": "sa",
"DB_PASSWORD": "비밀번호"
}
}
}
}
현재(2026년 기준)는 프로젝트별 mcp.json으로 관리하는 방식이 가장 많이 사용됩니다.
Git으로 함께 관리할 수도 있어 팀 프로젝트에서도 활용하기 좋습니다.
8. AI가 실제로 무엇을 할 수 있을까?
MCP가 연결되면 Cursor는 실제 데이터베이스를 조회할 수 있습니다.
예를 들어 다음과 같은 요청이 가능합니다.
Customers 테이블 구조를 분석해줘.
PK와 FK를 설명해줘.
Entity를 만들어줘.
Dapper Repository를 작성해줘.
JOIN 최적화를 추천해줘.
인덱스 개선점을 알려줘.
사용하지 않는 컬럼을 찾아줘.
이 Stored Procedure를 리팩터링해줘.
ERD를 Mermaid로 그려줘.
이제 AI에게 스키마를 복사해서 붙여넣을 필요가 없어집니다.
9. 실무에서 가장 많이 사용하는 프롬프트
예를 들어 아래와 같이 요청할 수 있습니다.
현재 등록된 MSSQL MCP를 이용하여 Products, Sales, Customers 테이블 구조를 분석해 주세요.
관계를 먼저 설명한 후
ASP.NET Core 8
Dapper
MediatR
CQRS
기준으로
Entity
Repository
Query Handler
Response DTO
까지 생성해 주세요.
NULL 처리와 decimal 계산은 모두 고려하고
JOIN은 Index를 활용하도록 작성해 주세요.