Interactive Review MCP 服务端
使用说明(简明易懂,便于上手):
-
项目简介
- 该仓库实现了一个 MCP 服务器插件,名称为“interactive-review”,提供一个名为 start_review 的工具,用于将给定的 Markdown 内容转化为可审阅的交互界面,并在本地打开一个浏览器窗口让人类用户进行勾选、添加评论、提交审核,最后返回结构化结果给调用方。
-
主要功能点
- 通过 MCP 的工具接口对外暴露 start_review 工具,支持接收 Markdown 内容和标题等参数。
- 启动一个本地简易的 HTTP 服务器并生成一个内嵌 UI(HTML/JS/CSS),用于对 Markdown 内容进行逐行/选区级别的评论和勾选。
- 自动打开浏览器展示 UI,等待用户输入并提交结果。
- 将用户的审阅结果整理成标准的 JSON 结构并通过 MCP 返回给客户端。
-
安装步骤
- 准备环境:需要 Python3 以及 MCP 客户端/框架依赖。仓库中工具依赖标注为 mcp>=1.0.0 之类的组件。
- 下载/获取代码:克隆或下载本仓库中的 interactive-review 路径。
- 启动服务器:在包含 MCP 服务端脚本的目录下执行服务器入口脚本(通常为 server.py)来启动。
- 运行后,工具会在本地打开一个浏览器界面,你可以在 UI 中完成审阅并提交,服务器将返回结构化结果。
-
服务器配置(对 MCP 客户端),以 JSON 形式示例说明(仅供参考,实际客户端无需包含代码): { "serverName": "interactive-review", "command": ["python3", "/path/to/YoungjaeDev/my-claude-plugins/plugins/interactive-review/mcp-server/server.py"], "args": [], "description": "MCP 服务器插件:Interactive Review,提供 start_review 工具以对给定 Markdown 内容进行交互式审阅并返回结构化结果。" }
注释说明:
- serverName:MCP 客户端识别的服务器名称,应与实现中的插件名称保持一致。
- command:启动服务器的执行命令及其路径。示例给出为 Python3 调用 server.py 的完整路径,请根据实际部署位置填写绝对路径。
- args:启动命令的附加参数,如果无附加参数则留空或为空列表。
- 该配置仅用于客户端识别与连接,实际调用仍通过 MCP 的初始化/通信协议进行,客户端本身不需要浏览或修改此配置。
-
基本使用方法
- 客户端通过 MCP 连接并注册 interactive-review 插件。
- 调用 start_review 内容(包含 Markdown 内容和可选标题)。
- 服务器生成本地 UI、打开浏览器等待用户评审,评审结束后返回结构化结果给客户端。
- 客户端解析返回的结果,进行后续处理或存档。