Zero MCP Net

MCPAI代理

提供方 ZeroMcp

AI代理 未标注 会话登录 社区 / 第三方

ZeroMCP是一个企业级MCP(Model Context Protocol)支持框架,用于将现有的ASP.NET Core API端点暴露为MCP工具、资源、模板和提示,无需创建第二个服务或重复逻辑。

一句话选型结论

按资料字段整理

Zero MCP Net 属于AI代理类 MCP 服务器,传输方式未标注,会话登录,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

MCP协议C#本地部署ASP.NETCore企业级框架API集成LLM连接

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zero MCP Net当前 2 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ZeroMcp上游标注的维护方 ZeroMcp
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

ZeroMCP.net

企业级MCP支持ASP。NET核心API。

ZeroMCP允许团队将现有的控制器和最小API端点公开为MCP(模型上下文协议)工具、资源、模板和提示,而无需创建第二个服务或复制逻辑。

执行摘要

  • 它解决了什么: 将LLM客户端连接到已建立的ASP。NET核心API安全快速。
  • 它是如何工作的: 注释端点([Mcp], [McpResource], [McpTemplate], [McpPrompt])或使用最少的API元数据(.AsMcp, .AsResource, .AsTemplate, .AsPrompt),然后绘制一条MCP路线。
  • 企业为什么采用它: 保持现有的身份验证、策略、验证、可观察性和发布控制。

核心能力

  • 通过您的真实ASP进行进程调度。NET核心管道
  • 流式HTTP MCP端点(GET 和 POST)
  • 本地/桌面MCP客户端的可选stdio传输
  • 流媒体工具结果通过 IAsyncEnumerable
  • 一个框架中的工具、资源、模板和提示
  • 按工具治理(角色、策略、过滤器)
  • 可观察性挂钩(相关性、日志、指标接收器、OpenTetry标签)
  • 用于发现和受控测试的检查器端点
  • 用于分阶段客户端迁移的版本化MCP路由

建筑概览

  1. API启动发现来自控制器和最小API的MCP元数据。
  2. ZeroMCP构建模式和端点描述符。
  3. MCP客户端呼叫 /mcp 使用JSON-RPC方法。
  4. ZeroMCP在进程中调度到您的原始端点。
  5. 响应被归一化为MCP兼容的输出。

该模型保留了中间件行为,避免了“影子实现”

快速开始

1) 安装软件包```xml


### 2) 注册和地图```csharp
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();

builder.Services.AddZeroMCP(options =>
{
options.ServerName = "Orders Platform";
options.ServerVersion = "1.0.0";
});

var app = builder.Build();

app.MapControllers();
app.MapZeroMCP(); // registers GET+POST /mcp

app.Run();

3) 将端点显示为MCP```csharp

[HttpGet("{id:int}")]
[Mcp("get_order", Description = "Retrieves an order by ID.")]
public IActionResult GetOrder(int id) => Ok(new { id });

app.MapGet("/api/health", () => Results.Ok(new { status = "ok" }))
.AsMcp("health_check", "Returns API health status.");


## 企业部署指南

### 安全基线

- 使用现有的身份验证/授权保护MCP端点:```csharp
app.MapZeroMCP().RequireAuthorization("McpPolicy");
  • 使用强制最小特权 Roles 和 Policy 关于工具元数据。
  • 在受信任的环境之外禁用或限制检查器端点。
  • 仅通过转发所需的安全标头 ForwardHeaders.

治理

  • ToolFilter:按名称/环境排除发现时间。
  • ToolVisibilityFilter:基于上下文的每个请求的动态可见性。
  • 角色/策略在列表和调用边界处强制执行。
  • 使用版本化路由在客户群体中运行受控切换。

可观察性和操作

  • 通过可配置的标头传播关联ID。
  • 围绕MCP请求生命周期和工具调用的结构化日志记录。
  • IMcpMetricsSink 用于自定义遥测输出。
  • 可选的OpenTetry痕迹富集功能。
  • 基于SSE的长寿命MCP连接的保持活动行为。

可靠性建议

  • 在ASP上设置端点身份验证和速率限制策略。NET核心层。
  • 对待 /mcp 作为具有正常SLO/SLA控制的生产API表面。
  • 将检查器UI置于环境检查或内部访问控制之后。
  • 在客户端推出之前,通过集成测试验证关键工具流。

配置示例```csharp

builder.Services.AddZeroMCP(options =>
{
options.ServerName = "Orders Platform";
options.ServerVersion = "2.3.0";
options.RoutePrefix = "/mcp";

// Core behavior
options.IncludeInputSchemas = true;
options.ForwardHeaders = ["Authorization"];

// Governance
options.ToolFilter = name => !name.StartsWith("internal_");
options.ToolVisibilityFilter = (name, ctx) =>
ctx.User.IsInRole("Admin") || !name.StartsWith("admin_");

// Observability
options.CorrelationIdHeader = "X-Correlation-ID";
options.EnableOpenTelemetryEnrichment = true;

// Optional MCP capabilities
options.EnableResources = true;
options.EnablePrompts = true;
options.EnableToolInspector = false;
options.EnableToolInspectorUI = false;
});


## 支持的MCP表面

- `initialize`
- `tools/list`, `tools/call`
- `resources/list`, `resources/templates/list`, `resources/read`
- `resources/subscribe`, `resources/unsubscribe` (启用时)
- `prompts/list`, `prompts/get`
- 通知流,如列表更改更新(启用时)

## 运输选项

### 流式HTTP(默认)

- `GET /mcp` 用于元数据和SSE场景
- `POST /mcp` JSON-RPC方法

### stdio(可选)```csharp
if (args.Contains("--mcp-stdio"))
{
await app.RunMcpStdioAsync();
return;
}

对于直接生成服务流程的本地优先MCP客户端很有用。

克劳德桌面stdio示例```json

{
"mcpServers": {
"orders-api": {
"command": "dotnet",
"args": ["run", "--project", "ZeroMCP.Sample", "--", "--mcp-stdio"]
}
}
}


有关完整的客户端设置选项(stdio和HTTP),请参阅 `wiki/Connecting-Clients.md`.

## 检查器端点

- `GET /mcp/tools`:JSON工具和模式清单
- `GET /mcp/ui`:基于浏览器的调用UI

建议用法:仅在开发和内部测试环境中启用。

## 版本控制和兼容性

- 语义版本控制策略在中定义 `VERSIONING.md`.
- MCP协议行为是通过显式兼容性测试实现的。
- 版本化端点支持允许客户端不中断迁移路径。

## 解决方案布局

- `ZeroMCP/`:核心框架包(NuGet工件源)
- `ZeroMCP.Sample/`:具有实用模式的参考主机
- `ZeroMCP.Tests/`:集成和模式/兼容性测试
- `examples/`:重点场景示例:
- `Minimal`
- `WithAuth`
- `WithEnrichment`
- `WithStdio`
- `WithRateLimiting`
- `Enterprise`
- `wiki/`:实施和运营文件
- `progress.md`:持久工程变更日志

## `[Mcp]` 属性快速参考

`[Mcp]` 支持所需的工具名称以及用于可发现性和治理的可选元数据。```csharp
[Mcp(
"create_order",
Description = "Creates an order.",
Tags = new[] { "orders", "write" },
Category = "orders",
Examples = new[] { "Create order for Alice, quantity 2" },
Hints = new[] { "idempotent", "cost=low" },
Roles = new[] { "Admin" },
Policy = "RequireEditor",
Version = 2
)]

详细信息: wiki/The-Mcp-Attribute.md.

其他属性快速参考

在从控制器操作中暴露MCP资源和提示时使用这些:```csharp
[McpResource("catalog://info", "catalog_info",
Description = "Returns catalog metadata.",
MimeType = "application/json")]

[McpTemplate("catalog://products/{id}", "product_resource",
Description = "Returns a product by ID.",
MimeType = "application/json")]

[McpPrompt("restock_recommendation_prompt",
Description = "Generates a restock recommendation prompt.")]


最低API当量:```csharp
app.MapGet("/api/catalog/info", () => Results.Ok(...))
.AsResource("catalog://info", "catalog_info", "Returns catalog metadata.", mimeType: "application/json");

app.MapGet("/api/catalog/products/{id:int}", (int id) => Results.Ok(...))
.AsTemplate("catalog://products/{id}", "product_resource", "Returns a product by ID.", mimeType: "application/json");

app.MapGet("/api/catalog/prompts/restock/{productId:int}", (int productId) => Results.Ok(...))
.AsPrompt("restock_recommendation_prompt", "Generates a restock recommendation prompt.");

详细信息: wiki/Resources-and-Prompts.md.

构建和测试```bash

dotnet build ZeroMCP.slnx -v detailed
dotnet test ZeroMCP.Tests/ZeroMCP.Tests.csproj -v detailed
```

集成测试包括MCP流式HTTP行为(例如GET /mcp 随着 Accept: text/event-stream 和 Mcp-Session-Id, resources/subscribe 带有会话头,以及 notifications/resources/updated 在SSE频道上)。看 McpResourceSubscriptionTests 和 McpClientCompatibilityTests 在 ZeroMCP.Tests/.

文档地图

  • 软件包自述: ZeroMCP/README.md
  • 配置: wiki/Configuration.md
  • 安全模型: wiki/Security-Model.md
  • 企业使用情况: wiki/Enterprise-Usage.md
  • 工具版本控制: wiki/Tool-Versioning.md
  • 资源和提示: wiki/Resources-and-Prompts.md

贡献

值得欢迎的贡献,尤其是在协议兼容性强化、最小API绑定奇偶性和以生产为重点的样本方面。请在每次功能更改时包括集成测试和文档更新。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Zero MCP Net 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zero MCP Net 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zero MCP Net 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zero MCP Net 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Zero MCP Net 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 API集成、C#、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。