跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何在 .NET 應用程式中內嵌 StackQL MCP 伺服器

StackQL 的 MCP 伺服器可以在 .NET 應用程式內執行,無需另外安裝,也沒有執行階段相依性。StackQL.Mcp 套件會在官方 C# MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,讓 worker 服務或代理程式取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。這正是 driftwatch 背後的模式,它是一個排程執行漂移檢查的 worker 服務。

步驟​

  1. 新增套件:
dotnet add package StackQL.Mcp

另有選用的 StackQL.Mcp.AgentFramework 套件,可提供 Agent Framework 整合。需要 .NET 8 或更新版本(套件以 net8.0 和 net9.0 為多目標)。

  1. 啟動伺服器並呼叫工具。建立器預設為 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()。

  1. 選擇模式。.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。