Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

.NET / C#

Nhúng máy chủ MCP StackQL vào một ứng dụng .NET, dưới dạng sidecar được tải xuống hoặc được đưa vào bản dựng của bạn theo kiểu vendoring dưới dạng một tệp thực thi độc lập. Ứng dụng khách là SDK MCP chính thức cho C#.

thông tin

Tệp nhị phân nhúng được tải xuống và xác minh sha256 trong lần chạy đầu tiên, hoặc được đưa vào ứng dụng của bạn theo kiểu vendoring. Xem hợp đồng chung.


Cài đặt​

dotnet add package StackQL.Mcp

Gói tùy chọn StackQL.Mcp.AgentFramework bổ sung khả năng tích hợp Agent Framework. Yêu cầu .NET 8 trở lên.


Bắt đầu nhanh​

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 gồm StackqlMcp.CreateBuilder() với .WithMode(), .WithAuth(), .WithBinary(), .WithBundlePath(), .WithApproot() và .WithCommand(), sau đó là .StartAsync(), .ListToolsAsync() và .CallToolAsync().


Chế độ​

Builder mặc định dùng StackqlMode.ReadOnly. Gọi .WithMode() với StackqlMode.Safe, StackqlMode.DeleteSafe hoặc StackqlMode.FullAccess để nâng mức quyền. Việc nâng mức quyền phải được thực hiện một cách rõ ràng - máy chủ sẽ không bật các công cụ thay đổi dữ liệu hoặc công cụ vòng đời trừ khi bạn chủ động bật.


Vendoring / nhúng​

Có hai cách để lấy tệp nhị phân:

  • Sidecar (mặc định) - bundle của nền tảng được tải xuống trong lần chạy đầu tiên, được xác minh sha256, được lưu vào cache tại ~/.stackql/mcp-server-bin/<version>/<platform-key>/ và được khởi chạy qua stdio.
  • Vendored - nhúng bundle như một tài nguyên của bản dựng để tạo ra một tệp thực thi độc lập:
dotnet build -p:StackqlVendorBundle=/path/to/stackql-mcp-windows-x64.mcpb

Bạn cũng có thể ghi đè tệp nhị phân hoặc bundle khi chạy bằng biến môi trường STACKQL_MCP_BIN hoặc STACKQL_MCP_BUNDLE.


Ứng dụng minh họa​

driftwatch là một .NET Worker Service nhúng máy chủ StackQL ở chế độ chỉ đọc và chạy theo lịch một bộ kiểm tra sai lệch bằng SQL (phơi bày công khai, thiếu tag hoặc giấy phép, sai lệch so với đường cơ sở), sau đó đăng kết quả lên một Adaptive Card của Teams.


github.com/stackql/stackql-mcp-dotnet