Skip to content

Commit 2d93f83

Browse files
王璨claude
andcommitted
doc: refresh MCP README for latest transport semantics
Document streamable HTTP defaults, legacy SSE fallback, richer MCP browser status, and updated MCP app result fields so the README matches the upgraded runtime behavior. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 41754ba commit 2d93f83

1 file changed

Lines changed: 13 additions & 8 deletions

File tree

README.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ node dist/dscode.mjs
101101
| 上下文管理 | 自动压缩长对话,防止 token overflow;1M token 窗口 |
102102
| 记忆系统 | 跨 session 记住用户偏好和项目上下文 |
103103
| Skills 系统 | 声明式第三方 Skill 扩展(SKILL.md),按需激活 |
104-
| MCP 协议 | 作为 MCP Client 连接外部工具服务器(stdio/SSE) |
104+
| MCP 协议 | 作为 MCP Client 连接外部工具服务器(stdio / streamable-http / legacy SSE) |
105105
| 图片 OCR | 基于 tesseract.js 的文字提取,支持中英文 |
106106
| 两级配置 | 用户级 + 项目级配置,环境变量覆盖 |
107107

@@ -161,8 +161,9 @@ DeepSeek reasoning 模型通过 `thinkingLevel` 控制思考强度,切换模
161161
| 能力 | 说明 |
162162
| --- | --- |
163163
| **Stdio 传输** | 启动本地进程作为 MCP Server,零网络开销 |
164-
| **SSE 传输** | 连接远程 MCP Server,支持分布式工具调用 |
165-
| **自动 Transport 推断** |`command` → stdio,仅 `url` → SSE,零配置 |
164+
| **Streamable HTTP 传输** | 连接远程 MCP Server,优先使用 2025-11-25 MCP 主路径 |
165+
| **Legacy SSE 兼容** | 远端不支持新传输时,可显式指定或自动回退到旧版 SSE |
166+
| **自动 Transport 推断** |`command` → stdio,仅 `url` → streamable-http,零配置 |
166167
| **工具命名空间** | `mcp_<server>_<tool>` 格式,避免冲突 |
167168
| **容错降级** | Server 连接失败不阻塞启动,错误信息可观测 |
168169

@@ -195,14 +196,18 @@ DeepSeek reasoning 模型通过 `thinkingLevel` 控制思考强度,切换模
195196
| --- | --- | --- | --- |
196197
| `command` | string | stdio 必填 | 启动命令 |
197198
| `args` | string[] || 命令参数 |
198-
| `url` | string | SSE 必填 | SSE 服务端 URL |
199-
| `transport` | `"stdio" \| "sse"` || 传输方式(自动推断) |
199+
| `url` | string | 远端传输必填 | 远程 MCP Server URL |
200+
| `transport` | `"stdio" \| "streamable-http" \| "sse"` || 传输方式;未显式指定时,`url` 默认走 `streamable-http` |
200201
| `description` | string || 描述信息 |
201202
| `env` | object || 自定义环境变量 |
203+
| `headers` | object || 远程 MCP 请求头 |
204+
| `preferredProtocolVersion` | string || 首选 MCP 协议版本,默认 `2025-11-25` |
205+
| `allowLegacySseFallback` | boolean || 远端不支持新传输时是否允许回退到 legacy SSE |
206+
| `requestTimeoutMs` / `connectTimeoutMs` | number || 请求 / 连接超时 |
202207

203208
MCP 工具注册为 Driver,命名格式 `mcp_<server>_<tool>`,例如 `mcp_blender_get_scene_info`。连接失败不阻塞启动,错误信息输出到控制台。
204209

205-
可在 TUI 中输入 `/mcp` 打开交互式浏览器:先选择 MCP server,再查看该 server 的 tool 列表与加载状态
210+
可在 TUI 中输入 `/mcp` 打开交互式浏览器:先选择 MCP server,再查看该 server 的 tool 列表、加载状态,以及 transport / protocol version / compatibility mode / refresh 状态
206211

207212
## Skills system
208213

@@ -314,7 +319,7 @@ Always push the branch before creating a PR.
314319

315320
| 示例 | 说明 | 快速开始 |
316321
| --- | --- | --- |
317-
| `examples/scenario-modeler` | 一个 SaaS 场景建模 MCP Server。演示 tool 返回 `structuredContent` 后,dscode 如何渲染 MCP App;没有 server HTML 时走 MDX,有 HTML resource 时优先使用 server 自带页面。 | `cd examples/scenario-modeler && npm install && npm start` |
322+
| `examples/scenario-modeler` | 一个 SaaS 场景建模 MCP Server。演示 tool 返回 `structuredContent` / `isError` 后,dscode 如何渲染 MCP App;没有 server HTML 时走 MDX,有 HTML resource 时优先使用 server 自带页面。 | `cd examples/scenario-modeler && npm install && npm start` |
318323

319324
更多使用说明见:
320325
- `examples/scenario-modeler/README.md`
@@ -329,7 +334,7 @@ src/
329334
├── memory/ # 跨 session 记忆
330335
├── drivers/ # 驱动注册 + 内置驱动 (fs, shell, search)
331336
├── skills/ # Skill 管理器 + SKILL.md 加载器
332-
├── mcp/ # MCP 客户端(stdio/SSE)+ 管理器 + MCP App host/runtime
337+
├── mcp/ # MCP 客户端(stdio / streamable-http / legacy SSE)+ 管理器 + MCP App host/runtime
333338
├── permissions/ # 权限拦截
334339
└── ui/ # REPL、流式渲染、slash commands
335340
```

0 commit comments

Comments
 (0)