内容
<p align="center">
<img src="assets/logo.png" alt="MCPZERO" width="128" height="128" />
</p>
<h1 align="center">MCPZERO</h1>
<p align="center">
<strong>数分钟内发布、聚合、保护和共享本地MCP服务器。</strong>
</p>
<p align="center">
<a href="https://mcpzero.io">官网</a> ·
<a href="https://mcpzero.io/docs/">文档</a> ·
<a href="https://mcpzero.io/app">控制面板</a>
</p>
MCPZERO是一个**安全的MCP聚合网关**，适用于 [模型上下文协议](https://modelcontextprotocol.io)。它结合了语义聚合、渐进式工具发现和零信任安全，使您能够发布和共享本地MCP服务器，而无需暴露域名、端口、TLS或凭证。
```
您的MCP服务器（无认证） ──隧道──▶ gw.mcpzero.io ──▶ 聚合网关 ──▶ Cursor / Claude / Codex
│ （认证 · 聚合 · 审计）
控制面板：端点、API密钥、调用账本
```
## 为什么选择MCPZERO
| 支柱 | 含义 |
|--------|---------------|
| **零配置** | 读取您现有的 `mcp.json` 并通过一个加密隧道复用每个本地stdio服务器 — 无需管理域名、TLS或托管。 |
| **零信任** | 每个公共端点都在边缘强制执行。客户端使用 `Authorization: Bearer` 进行身份验证；身份验证在5毫秒内完成，并且您的工具的协议表面永远不会暴露给互联网。 |
| **零泄漏** | 网关转发内存并仅保留元数据（工具、延迟、状态）。默认情况下，请求/响应正文永远不会存储 — 在付费层级上将完整审计日志流式传输到您自己的S3 / R2 / OSS。 |
| **零摩擦** | 工具的语义渐进式发现减少了令牌使用和“上下文膨胀” |
## 语义聚合
在单个端点后面组合多个本地MCP服务器。每个服务器都保留其自己的公共路径；端点根成为一个**元服务器**，用于将工具调用路由到正确的后端。
```bash
mcpzero tunnel start --endpoint ep_abc123 --mcp-config ./mcp.json
# 读取 mcp.json → postgres、filesystem、puppeteer — 一个隧道，多个服务器
```
参见 [示例 `mcp.json` 文件](examples/quickstart/mcp.json)
参见 [语义聚合](https://mcpzero.io/docs/gateway/semantic-aggregation/).
## 渐进式发现
AI客户端按需发现工具，而不是预先加载每个模式。元服务器公开 `meta_search` 和 `meta_call_tool`，以便代理在不浪费上下文令牌的情况下将意图与具体工具匹配。
参见 [渐进式发现](https://mcpzero.io/docs/gateway/progressive-discovery/).
## 网关智能
除了传输和认证外，MCPZERO还在边缘检查和协调MCP流量：
- **语义WAF** *(企业 · 路线图)* — 一种了解JSON-RPC和工具模式的内容感知防火墙。检查每个 `tools/call` 以获取恶意参数、不安全路径和数据泄露模式。
- **工具劫持防御** *(企业 · 路线图)* — 扫描工具参数和返回的内容以获取注入和越狱有效载荷，从而中和受损的工具。
- **团队共享和审计** — 在团队和企业计划上跨成员共享端点， 可视化流量，并保留可搜索的审计日志。
## 开始使用
**使用CLI隧道连接本地服务器：**
```bash
curl -fsSL https://mcpzero.io/install-cli.sh | sh`
# 或：brew install mcpzero/tap/mcpzero-cli
# 或：npm install -g mcpzero-cli
# 或：pipx install mcpzero-cli
mcpzero version
mcpzero login
mcpzero tunnel start --mcp-cmd "npx -y @modelcontextprotocol/server-filesystem /tmp"
```
CLI源代码位于 [`cli/`](./cli/)；参见其 [README](./cli/README.md) 以便从源代码构建和完整的命令参考。
## 仓库
| 仓库 | 内容 | 许可证 |
|------|------|---------|
| [`mcpzero`](https://github.com/mcpzero/mcpzero) | 此仓库 — 文档、示例、安装脚本、协议规范和CLI | MIT |
| [`homebrew-tap`](https://github.com/mcpzero/homebrew-tap) | `brew install mcpzero/tap/mcpzero-cli` | — |
## 文档
- 产品文档：https://mcpzero.io/docs （源代码位于 [`docs/`](./docs/)）
- 隧道线路协议：[`PROTOCOL.md`](./PROTOCOL.md)
- 可运行的示例：[`examples/`](./examples/)
## 许可证
此仓库中的内容（文档、示例、安装脚本）是MIT — 参见 [LICENSE](./LICENSE)。
