翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何在 .NET 應用程式中內嵌 StackQL MCP 伺服器
StackQL 的 MCP 伺服器可以在 .NET 應用程式內執行,無需另外安裝,也沒有執行階段相依性。StackQL.Mcp 套件會在官方 C# MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,讓 worker 服務或代理程式取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。這正是 driftwatch 背後的模式,它是一個排程執行漂移檢查的 worker 服務。
步驟
- 新增套件:
dotnet add package StackQL.Mcp
另有選用的 StackQL.Mcp.AgentFramework 套件,可提供 Agent Framework 整合。需要 .NET 8 或更新版本(套件以 net8.0 和 net9.0 為多目標)。
- 啟動伺服器並呼叫工具。建立器預設為
StackqlMode.ReadOnly:
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 });
建立器還提供 .WithBinary()、.WithBundlePath()、.WithApproot() 與 .WithCommand()。
- 選擇模式。
.WithMode()預設為StackqlMode.ReadOnly。只有在應用程式需要佈建時,才設定StackqlMode.Safe、StackqlMode.DeleteSafe或StackqlMode.FullAccess。權限提升需明確指定。
發行獨立式可執行檔
取得二進位檔的方式有兩種:
- Sidecar(預設):首次執行時下載平台安裝套件,經 sha256 驗證後快取於
~/.stackql/mcp-server-bin/<version>/<platform-key>/,並透過 stdio 啟動。 - Vendored:將安裝套件內嵌為建置資源:
dotnet build -p:StackqlVendorBundle=/path/to/stackql-mcp-windows-x64.mcpb
在執行階段使用 STACKQL_MCP_BIN 或 STACKQL_MCP_BUNDLE 環境變數覆寫二進位檔或安裝套件。
示範應用程式
driftwatch 是一個 .NET Worker Service,它內嵌唯讀的 StackQL 伺服器,並依排程執行一系列 SQL 漂移檢查(公開暴露、缺少標籤或授權、基準漂移),再將檢查結果張貼到 Teams Adaptive Card。
相關概念
- 內嵌式 MCP:.NET / C# 參考:安裝、API 與 vendoring
- 如何搭配 AI 代理程式使用 StackQL:MCP 模型與安全模式
- StackQL MCP 架構:傳輸方式、模式與稽核內部機制
- 什麼是代理式基礎架構?:此做法促成的模式