Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

.NET / C#

Вбудуйте сервер MCP StackQL у застосунок .NET: або як завантажений sidecar, або через вендоринг у вашу збірку як автономний виконуваний файл. Клієнт - офіційний SDK MCP для C#.

інформація

Вбудований двійковий файл завантажується й перевіряється за 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. Щоб підвищити рівень доступу, викличте .WithMode() зі значенням StackqlMode.Safe, StackqlMode.DeleteSafe або StackqlMode.FullAccess. Підвищення рівня доступу відбувається лише явно - сервер не вмикає інструменти змінення даних і операцій життєвого циклу, якщо ви явно їх не ввімкнете.


Вендоринг / вбудовування​

Отримати двійковий файл можна двома способами:

  • Sidecar (за замовчуванням) - пакет для платформи завантажується під час першого запуску, перевіряється за 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 - це .NET Worker Service, що вбудовує сервер StackQL у режимі лише для читання, за розкладом запускає набір перевірок дрейфу на SQL (публічний доступ, відсутні теги чи ліцензії, дрейф відносно базового стану) і надсилає результати в Adaptive Card у Teams.


github.com/stackql/stackql-mcp-dotnet