중요합니다
MCP(SQL 모델 컨텍스트 프로토콜) 서버는 미리 보기 상태이며 이 설명서와 엔진 구현이 변경 될 수 있습니다. Data API Builder 버전 1.7은 미리 보기 상태이지만 MCP 기능이 태그에 아직 포함되지 1.7.83-rc 않았기 때문에 시험판 버전을 명시적으로 사용해야 합니다(예:latest: ).
이 빠른 시작에서는 데이터 API 작성기 CLI를 사용하여 Aspire 없이 SQL MCP 서버를 로컬로 실행합니다. 데이터베이스를 만들고, 구성 파일을 구성하고, SQL MCP Server를 시작하고, 사용자 지정 도구를 사용하여 VS Code(Visual Studio Code)에서 데이터베이스에 연결합니다. 이 경로는 컨테이너 또는 호스팅 프레임워크 없이 SQL MCP Server를 탐색하는 가장 쉬운 방법입니다.
필수 조건
시작하기 전에 이러한 도구를 설치합니다.
.NET 9 이상
이 도구가 이미 설치되어 있을 수 있습니다.
dotnet --version을 실행하고 버전이 9.0 이상인지 확인합니다. .NET이 이미 있는 경우 다시 설치는 안전하며 런타임만 새로 고칩니다.
SQL Server 2016+
SQL Server 데이터베이스에 액세스해야 합니다. 다음 작업 중 한 가지:
- SQL Server (개발자 또는 Express)
- LocalDB(파일 기반 SQL Server)
- Docker의 SQL Server
Data API Builder CLI 설치
dotnet new tool-manifest
dotnet tool install microsoft.dataapibuilder --prerelease
dotnet tool restore
비고
SQL MCP Server는 현재 시험판에 있습니다. 플래그를 --prerelease 사용하면 이 빠른 시작에 사용된 모든 기능을 사용하여 최신 버전의 Data API 작성기를 얻을 수 있습니다.
1단계: 샘플 데이터베이스 만들기
이 단계에서는 이름이 지정된 ProductsDb 데이터베이스를 만들고 이름이 Products지정된 단일 테이블로 시드합니다.
SQLCMD, SQL Server Management Studio 또는 원하는 도구를 사용하여 SQL 인스턴스에 연결한 다음, 다음을 실행합니다.
CREATE DATABASE ProductsDb;
GO
USE ProductsDb;
GO
CREATE TABLE dbo.Products (
Id INT PRIMARY KEY,
Name NVARCHAR(100) NOT NULL,
Inventory INT NOT NULL,
Price DECIMAL(10,2) NOT NULL,
Cost DECIMAL(10,2) NOT NULL
);
INSERT INTO dbo.Products (Id, Name, Inventory, Price, Cost)
VALUES
(1, 'Action Figure', 40, 14.99, 5.00),
(2, 'Building Blocks', 25, 29.99, 10.00),
(3, 'Puzzle 500 pcs', 30, 12.49, 4.00),
(4, 'Toy Car', 50, 7.99, 2.50),
(5, 'Board Game', 20, 34.99, 12.50),
(6, 'Doll House', 10, 79.99, 30.00),
(7, 'Stuffed Bear', 45, 15.99, 6.00),
(8, 'Water Blaster', 35, 19.99, 7.00),
(9, 'Art Kit', 28, 24.99, 8.00),
(10,'RC Helicopter', 12, 59.99, 22.00);
샘플 데이터베이스가 준비되었습니다.
2단계: SQL MCP 서버 구성
다음 파일을 만들고자 하는 폴더에서 모든 명령을 실행하세요 dab-config.json.
환경 파일 만들기
작업 디렉터리에 명명된 .env 파일을 만들고 다음 줄을 추가합니다(SQL Server 정보로 사용자 지정).
MSSQL_CONNECTION_STRING=Server=localhost;Database=ProductsDb;Trusted_Connection=True;TrustServerCertificate=True
비고
통합 인증(Trusted_Connection=True)은 Windows에서 작동합니다. SQL 인증(Docker 또는 플랫폼 간에서 공통)의 경우 대신 사용합니다 Server=localhost,1433;Database=ProductsDb;User Id=sa;Password=<YourPassword>;TrustServerCertificate=True (컨테이너가 포트 1433을 localhost에 매핑하는 것으로 가정).
데이터 API 작성기에서는 작업 디렉터리에 있을 때 로컬 .env 파일에서 변수를 읽을 수 있습니다. 사용자 환경이 파일을 지원하지 .env 않는 경우 다음 명령을 실행하기 전에 터미널 세션에서 환경 변수로 설정합니다 MSSQL_CONNECTION_STRING .
서버 초기화 및 구성
다음 명령어를 실행하세요:
dab init --database-type mssql --connection-string "@env('MSSQL_CONNECTION_STRING')" --host-mode Development --config dab-config.json
dab add Products --source dbo.Products --permissions "anonymous:read" --description "Toy store products with inventory, price, and cost."
필요에 따라 필드 설명 추가
dab update Products --fields.name Id --fields.primary-key true --fields.description "Product Id"
dab update Products --fields.name Name --fields.description "Product name"
dab update Products --fields.name Inventory --fields.description "Units in stock"
dab update Products --fields.name Price --fields.description "Retail price"
dab update Products --fields.name Cost --fields.description "Store cost"
SQL MCP 서버가 완전히 구성되었습니다.
3단계: SQL MCP 서버 시작
VS Code에서 연결하기 전에 별도의 터미널에서 SQL MCP 서버를 시작합니다.
터미널을 열고 실행
dab start --config dab-config.json
이 명령은 SQL MCP 서버를 시작합니다. 시작 후 터미널 출력은 수신 대기 URL을 표시합니다. 이 빠른 시작에서는 MCP 엔드포인트가 http://localhost:5000/mcp라고 가정합니다. 이 터미널을 계속 실행합니다. Visual Studio Code는 이 HTTP 엔드포인트에 연결합니다.
비고
에서 런타임 설정을 dab-config.json 구성하거나 다음과 같은 ASPNETCORE_URLS환경 변수를 설정하여 포트를 사용자 지정할 수 있습니다.
4단계: VS Code에서 연결
중요합니다
작업 영역은 VS Code에서 프로젝트로 처리하는 루트 폴더입니다. 설정 및 MCP 서버 정의는 해당 폴더 내에만 적용됩니다. 단일 파일을 열면 작업 영역에 있지 않습니다. 폴더를 열어야 합니다.
프로젝트 폴더 열기
- 파일>열기 폴더를 선택합니다.
-
dab-config.json파일이 포함된 폴더를 엽니다.
MCP 서버 정의 만들기
명명 .vscode/mcp.json 된 파일을 만들고 다음 콘텐츠를 추가합니다.
{
"servers": {
"sql-mcp-server": {
"type": "http",
"url": "http://localhost:5000/mcp"
}
}
}
파일을 저장합니다. VS Code는 MCP 서버 구성을 자동으로 검색합니다. 창을 다시 로드해야 할 수 있습니다(개발자: 명령 팔레트에서 창 다시 로드 ).
MCP 서버 연결 시작
- 명령 팔레트를 엽니다(macOS의 경우 Ctrl+Shift+P 또는 Cmd+Shift+P ).
- MCP 실행: 사용 가능한 서버를 보려면 서버를 나열합니다.
- sql-mcp-server를 선택하고 시작을 선택하여 연결합니다.
연결되면 Products 엔터티는 read_records 와 같은 MCP 도구(describe_entities)로 표시됩니다. 도구 이름은 구성에 따라 달라질 수 있습니다.
비고
VS Code MCP 지원은 진화하고 있습니다. 구성 스키마는 이후 릴리스에서 변경될 수 있습니다. 최신 지침은 MCP 통합에 대한 VS Code 설명서를 참조하세요.
도구 호출 시도
VS Code Copilot 채팅을 열고 다음 프롬프트를 시도합니다.
Which products have an inventory under 30?