Reasonix · 第 7 章 MCP 插件与 Extension Protocol

Reasonix · 第 7 章 MCP 插件与 Extension Protocol

章节摘要:本章深潜 Reasonix 的两层扩展体系。第一层是 MCP(Model Context Protocol)stdio JSON-RPC 客户端(internal/plugin),适配远程工具/prompts/resources;第二层是 Extension Protocol v1 sidecar(internal/extension),能拦截运行时事件、提供 Provider、提供结构化 UI、发布版本化插件包(Plugin Manifest v1)。sdk/go 让第三方用 Go 编写 sidecar。这是学习 MCP 集成、JSON-RPC 子进程通信、插件分发的优质真实案例。本章共 3 节,前置依赖为第 1-6 章。

契约坐标

学习目标

1. 区分两层扩展(编译期 init() vs 运行时外部)。
2. 理解 MCP stdio JSON-RPC 客户端。
3. 理解 Extension Protocol v1 sidecar。
4. 认识 Plugin Manifest v1 版本化插件包。
5. 了解 sdk/go 第三方 sidecar 开发。

子章节导航

01 SPEC §1.4 两层扩展与 MCP 插件客户端

两层扩展(编译期built-in init()自注册/运行时外部插件stdio JSON-RPC);internal/plugin MCP客户端(stdio通信/JSON-RPC协议/适配远程tools+prompts+resources);MCP servers在config声明;cmd/reasonix-plugin-example参考示例;MCP兼容性。

02 Extension Protocol v1 sidecar 与拦截器

internal/extension Extension Protocol v1;sidecar子进程(比MCP更强:拦截运行时事件/贡献Provider/结构化UI hub);EXTENSION_PROTOCOL.md;拦截器(interceptor);与MCP的区别(MCP只贡献工具,Extension能拦截事件贡献Provider);PLUGIN_PACKAGES.md版本化插件包分发。

03 sdk/go 与插件开发实战

sdk/go让第三方用Go编写Extension sidecar;examples/starterextension入门示例(含中英README);examples/fullsidecar完整示例;Plugin Manifest v1格式;插件分发安装;plugin包生命周期管理。

前置知识与后续延伸

前置:第1-6章。后续:第8章三前端(Controller也能被Extension影响)。