Pular para o conteúdo principal
Página traduzida

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#.

informação

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.


github.com/stackql/stackql-mcp-dotnet