Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
.NET / C#
Incorpore o servidor MCP do StackQL em uma aplicação .NET, seja como um sidecar baixado, seja incluído no seu build por vendoring como um executável autocontido. O cliente é o SDK oficial do MCP para C#.
O binário incorporado é baixado e verificado com sha256 na primeira execução, ou incluído na sua aplicação por vendoring. Consulte o contrato comum.
Instalação
dotnet add package StackQL.Mcp
O pacote opcional StackQL.Mcp.AgentFramework adiciona a integração com o Agent Framework. Requer o .NET 8 ou posterior.
Início rápido
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 });
A API é StackqlMcp.CreateBuilder() com .WithMode(), .WithAuth(), .WithBinary(), .WithBundlePath(), .WithApproot() e .WithCommand(), e depois .StartAsync(), .ListToolsAsync() e .CallToolAsync().
Modos
O builder usa StackqlMode.ReadOnly por padrão. Chame .WithMode() com StackqlMode.Safe, StackqlMode.DeleteSafe ou StackqlMode.FullAccess para elevar o modo. A elevação é explícita - o servidor não habilita as ferramentas de mutação nem as de ciclo de vida, a menos que você as ative explicitamente.
Vendoring / incorporação
Duas formas de obter o binário:
- Sidecar (padrão) - o bundle da plataforma é baixado na primeira execução, verificado com sha256, armazenado em cache em
~/.stackql/mcp-server-bin/<version>/<platform-key>/e iniciado por stdio. - Vendored - incorpore o bundle como recurso de build para gerar um executável autocontido:
dotnet build -p:StackqlVendorBundle=/path/to/stackql-mcp-windows-x64.mcpb
Você também pode substituir o binário ou o bundle em tempo de execução com as variáveis de ambiente STACKQL_MCP_BIN ou STACKQL_MCP_BUNDLE.
Aplicativo de demonstração
driftwatch é um Worker Service do .NET que incorpora o servidor do StackQL em modo somente leitura e, de forma agendada, executa um conjunto de verificações de desvio em SQL (exposição pública, tags ou licenças ausentes, desvio em relação à linha de base) e publica os resultados em um Adaptive Card do Teams.