菜单
Create, debug, test, and publish MCP (Model Context Protocol) servers in C# using the official ModelContextProtocol SDK — tools/prompts/resources, stdio vs HTTP transport, MapMcp hosting. Use when building or changing an MCP server in the .NET backend (relevant to your agentic pipeline).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a domain entity, aggregate, or value object to the .NET API — rich mutable class with private ctor + static factory (UUIDv7), invariants that throw, tenant_id, identity equality; records for value objects. Use when modeling new domain state under apps/api/{{ProjectName}}.Domain.
Add a Minimal API endpoint (a feature/use case) to the .NET API — feature folder, IEndpoint self-registration, contract validation, Kommand dispatch, Result→ProblemDetails. Use when adding or changing an HTTP endpoint under apps/api/{{ProjectName}}.Api.
Author a CQRS command or query in the {{ProductName}} backend using the Kommand library, the three-scope validation model, and the Result<T> failure pattern. Use whenever creating or modifying a command/query/handler/validator in apps/api/{{ProjectName}}.Application, or wiring its endpoint in {{ProjectName}}.Api.
Choose and wire AI features in the .NET backend — LLM calls, agentic tool-calling/multi-step workflows, RAG/vector search, structured output, streaming. Use when adding or changing anything that talks to a model or orchestrates agents (your agentic pipeline). Tailored to our LLM provider + MAF + pgvector stack.
Scan .NET/C# code for performance anti-patterns (async, memory/strings, collections/LINQ, regex, serialization, I/O) with tiered severity, reporting findings without editing. Use when auditing hot paths, reviewing allocation-heavy code, or analyzing the API for optimization opportunities.
Add or change EF Core (Npgsql/PostgreSQL) persistence in the .NET backend — entities, EF configurations, repositories, queries, migrations. Use when adding a table/entity, a query, a repository, or a migration under apps/api.
| name | mcp-csharp |
| description | Create, debug, test, and publish MCP (Model Context Protocol) servers in C# using the official ModelContextProtocol SDK — tools/prompts/resources, stdio vs HTTP transport, MapMcp hosting. Use when building or changing an MCP server in the .NET backend (relevant to your agentic pipeline). |
| allowed-tools | Read, Glob, Grep, Edit, Write, Bash, mcp__serena__initial_instructions, mcp__serena__get_symbols_overview, mcp__serena__find_symbol, mcp__serena__find_referencing_symbols, mcp__serena__find_declaration, mcp__serena__find_implementations, mcp__serena__search_for_pattern, mcp__serena__get_diagnostics_for_file, mcp__serena__list_dir, mcp__serena__find_file, mcp__serena__create_text_file, mcp__serena__replace_symbol_body, mcp__serena__insert_after_symbol, mcp__serena__insert_before_symbol, mcp__serena__replace_content, mcp__serena__rename_symbol, mcp__serena__safe_delete_symbol |
Serena MCP is mandatory for C# code. First call
mcp__serena__initial_instructionsto load the Serena tool manual, then use the Serena tools for ALL.csreading / searching / navigation / creation / editing — prefer symbol navigation (get_symbols_overview/find_symbol/find_referencing_symbols) over whole-file reads. NativeEdit/Writeon.csis hook-blocked (the TS/React frontend uses the native tools).
For exposing tools/capabilities over the Model Context Protocol from the .NET backend (your agentic pipeline
on Microsoft Agent Framework is the natural consumer/producer). C# (.cs) edits via Serena.
⚠ Approval required.
ModelContextProtocol(core) andModelContextProtocol.AspNetCore(HTTP) plus theMicrosoft.McpServer.ProjectTemplatestemplate are NuGet dependencies — need Dan's explicit approval.
dotnet --version (need .NET 10+); dotnet new install Microsoft.McpServer.ProjectTemplates.dotnet new mcpserver -n <Name>; HTTP → dotnet new web -n <Name> + dotnet add package ModelContextProtocol.AspNetCore.[McpServerToolType] on the class, [McpServerTool] + [Description] on the method, a
[Description] on EVERY parameter, async tools take a CancellationToken:
[McpServerToolType]
public static class ProjectTools
{
[McpServerTool, Description("Summarize a project.")]
public static async Task<string> Summarize(
[Description("The project id.")] Guid projectId,
CancellationToken cancellationToken = default) => /* ... */;
}
readonly fields — NOT a primary
constructor (the upstream Microsoft sample uses class ApiTools(HttpClient http, ILogger log); we don't).[McpServerPromptType]/[McpServerPrompt] (return ChatMessage);
[McpServerResourceType]/[McpServerResource(UriTemplate="config://app", MimeType="application/json")].Host.CreateApplicationBuilder(args); builder.Logging.AddConsole(o => o.LogToStandardErrorThreshold = LogLevel.Trace); — logging to stdout corrupts JSON-RPC (the #1 error); AddMcpServer().WithStdioServerTransport().WithToolsFromAssembly();WebApplication.CreateBuilder(args); AddMcpServer().WithHttpTransport().WithToolsFromAssembly(); app.MapMcp(); app.MapGet("/health", () => "ok");dotnet build / dotnet run.apps/api/tests.).cs via Serena; async + CancellationToken throughout.Result<T>/error model where the tool contract allows.otel-instrumentation skill — transport-config supports OpenTelemetry; trace tool calls.