Skip to main content
Glama
patsypppe

broker

by patsypppe

Sentinel

一个无状态的 MCP 服务器,以及为它评分的符合性测试工具。

2026 年 7 月 28 日,Model Context Protocol 发布了其历史上最大的一次破坏性修订: 它将 MCP 从有状态、基于会话、双向的协议转变为无状态的请求/响应协议。会话消失了。initialize 握手消失了。 server/discover 成为必选项。服务器发起的请求被多轮往返请求(Multi Round-Trip Requests)整体取代。CacheableResult 成为必需项。Sampling、Roots、Logging、HTTP+SSE 传输和 OAuth 动态客户端注册都在十二个月的倒计时内被弃用。

野外所有的 MCP 服务器都是按照旧习惯编写的。这个仓库是两样东西捆绑在一起:

broker/

一个 Go MCP 服务器,原生构建于 2026-07-28 之上——无状态、基于句柄、仅 MRTR、经过审计。

harness/

sentinel,一个符合性测试工具,扫描任何 MCP 服务器,根据规范性要求(每条规则附带规范引用)对其进行评分,并盘点其已弃用功能的债务。

它们是有意耦合的。测试工具的可信度来自于对一个并非其自身的服务器进行评分;服务器的可信度来自于被评分。测试工具从不导入服务器内部实现,并且可以针对任何端点 URL 运行。

状态

进行中。 参见 docs/superpowers/plans/2026-08-22-sentinel-mvp.md 了解工作包计划,参见 docs/HANDOFF.md 了解本实现所依据的规范。

WP

能力

状态

WP-0

仓库引导

✅

WP-1

信封、发现、协商、错误分类

⏳

WP-2

头部契约和 Envoy 路由

⏳

WP-3

注册表、确定性 tools/list、CacheableResult

⏳

WP-4

工具纪律和 warehouse.query

⏳

WP-5

服务器铸造的状态句柄

⏳

WP-6

MRTR 引擎和幂等重放

⏳

WP-7

受众验证

⏳

WP-8

审计日志和哈希链

⏳

WP-9

测试工具探针、规则目录、夹具

⏳

WP-10

评分、JSON、SARIF、CI 门禁

⏳

WP-11

弃用清单

⏳

WP-12

测量、迁移指南、演示

⏳

Related MCP server: AIOrc MCP Server

快速开始

make up          # postgres + broker + envoy + smokescreen + otel-collector
make check       # golangci-lint, go test, ruff, mypy, pytest
make scan-broker # grade the broker against its own harness

需要 Go 1.23+、Python 3.12、uv ≥ 0.5 和 Docker。任何地方都不需要模型 API 密钥——broker 提供工具,不调用模型,这就是为什么 CI 快速、免费,并且永远不会因为本仓库之外的原因而失败。

文档

  • docs/HANDOFF.md — 实现规范(SN-HND-001)。

  • docs/MIGRATION.md — MCP 2026-07-28 中发生了什么变化,以及它让你付出什么代价。(WP-12)

  • CLAUDE.md — 四条规则和单源文件约束。

优先级

在本仓库与 MCP 规范 不一致的地方, 规范优先,本仓库是错误的。

许可证

MIT — 参见 LICENSE。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP-compatible LLM clients to execute server-verified agent workflows, with enforced transitions, invocation caps, and signed audit trails.
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Demonstrates stateful application patterns on the stateless MCP 2026-07-28 protocol, enabling request-scoped state, multi round-trip confirmations, and streaming progress updates across independent tool calls.
    -
  • F
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP-compatible AI clients to invoke CLI-driven agent tools over Streamable HTTP, including shell execution, file operations, patching, image viewing, web search, and nested agent tasks, with permission modes and real-time progress streaming.
    -