KEEL · 龙骨 · A CURRICULUM FOR THE AI ERA
MCP Protocol Engineering 配套项目：Incident Bridge — keel 龙骨
MCP Protocol Engineering 的配套项目：MCP Protocol Engineering 配套项目：Incident Bridge
这是一个只依赖 Python 标准库的确定性 MCP Bridge 教学实现。它把协议拆成几层：
JSON-RPC contracts -> lifecycle/discovery -> policy/auth -> tools/tasks -> transport/events
它覆盖协议工程的关键验证点，但不宣称是完整的 MCP SDK 或生产服务器。课程目标是先看懂边界，再替换基础设施。
运行环境
python -m pip install -r courses/foundation/mcp-protocol-engineering/course/project/requirements.txt
$env:PYTHONPATH = "courses/foundation/mcp-protocol-engineering/course/project/src"
python courses/foundation/mcp-protocol-engineering/course/project/examples/02_discovery.py
示例顺序
| 示例 | 观察重点 |
|---|---|
01_lifecycle.py |
initialize、notification、request id |
02_discovery.py |
版本协商、server/discover、明确拒绝 |
03_primitives.py |
经过 scope 过滤的 tools 列表和结构化结果 |
04_user_input.py |
input_required 与输入校验 |
05_transport.py |
传输关闭和取消边界 |
06_auth.py |
过期 token、scope 和租户绑定 |
07_task_recovery.py |
持久化快照、幂等和重启恢复 |
08_compatibility.py |
最小兼容矩阵与事件 |
测试
python -m pytest -q courses/foundation/mcp-protocol-engineering/course/project/tests
当前测试覆盖 JSON-RPC 形状、能力序列化、版本拒绝、发现过滤、输入错误、授权、任务恢复、传输关闭和 trace 事件。真实网络、OAuth、官方 SDK、Inspector 和 OpenTelemetry exporter 是生产替换点。