이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.
.NET / C#
StackQL MCP 서버를 .NET 애플리케이션에 내장합니다. 다운로드한 사이드카로 사용하거나, 빌드에 벤더링하여 자체 포함 실행 파일로 만들 수 있습니다. 클라이언트는 공식 C# MCP SDK입니다.
임베디드 바이너리는 첫 실행 시 다운로드되어 sha256으로 검증되거나, 앱에 벤더링됩니다. 공통 계약을 참조하세요.
설치
dotnet add package StackQL.Mcp
선택적 StackQL.Mcp.AgentFramework 패키지는 Agent Framework 통합 기능을 추가합니다. .NET 8 이상이 필요합니다.
빠른 시작
using StackQL.Mcp;
await using var server = await StackqlMcp.CreateBuilder()
.WithMode(StackqlMode.ReadOnly)
.WithAuth("github", "null_auth")
.StartAsync();
var tools = await server.ListToolsAsync();
var result = await server.CallToolAsync("list_services",
new() { ["provider"] = "github", ["row_limit"] = 5 });
API는 StackqlMcp.CreateBuilder() 메서드에 .WithMode(), .WithAuth(), .WithBinary(), .WithBundlePath(), .WithApproot(), .WithCommand() 메서드를 연결한 다음 .StartAsync(), .ListToolsAsync(), .CallToolAsync() 메서드를 호출하는 방식입니다.
모드
빌더의 기본값은 StackqlMode.ReadOnly입니다. 승격하려면 StackqlMode.Safe, StackqlMode.DeleteSafe 또는 StackqlMode.FullAccess 값으로 .WithMode() 메서드를 호출하세요. 승격은 명시적입니다. 옵트인하지 않으면 서버는 변경 작업 도구나 수명 주기 도구를 활성화하지 않습니다.
벤더링 / 내장
바이너리를 확보하는 방법은 2가지입니다:
- 사이드카(기본값): 플랫폼 번들을 첫 실행 시 다운로드하고, sha256으로 검증하고,
~/.stackql/mcp-server-bin/<version>/<platform-key>/디렉터리에 캐시한 다음, stdio를 통해 실행합니다. - 벤더링: 번들을 빌드 리소스로 내장하여 자체 포함 실행 파일을 만듭니다:
dotnet build -p:StackqlVendorBundle=/path/to/stackql-mcp-windows-x64.mcpb
STACKQL_MCP_BIN 또는 STACKQL_MCP_BUNDLE 환경 변수를 사용하여 런타임에 바이너리나 번들을 재정의할 수도 있습니다.
데모 앱
driftwatch는 읽기 전용 StackQL 서버를 내장한 .NET Worker Service입니다. 일정에 따라 일련의 SQL 드리프트 검사(공개 노출, 누락된 태그 또는 라이선스, 기준선 드리프트)를 실행하고 결과를 Teams Adaptive Card에 게시합니다.