Skip to content

docs(roadmap): plan MCP protocol alignment (0.5) and features borrowed from mcpc (0.6) - #19

Merged
github-actions[bot] merged 1 commit into
mainfrom
claude/wonderful-cerf-fv8ydk
Oct 21, 2026
Merged

github-actions[bot] merged 1 commit into
mainfrom
claude/wonderful-cerf-fv8ydk

Conversation

@ticoAg

@ticoAg ticoAg commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

What and why · 改了什么、为什么

对比 apify/mcpc(0.7.0)之后,把需要跟进和可借鉴的部分排进路线图。只改文档,不涉及行为。

0.5 MCP 协议对齐(必须做,可与 0.4 并行)

  • e1 迁移到官方 TypeScript SDK v2:当前锁定的 @modelcontextprotocol/sdk 1.32.1 最高只到 2025-11-25;OAuth 登录的探测请求写死了 2025-06-18
  • e2 2026-07-28 无状态协议:server/discover 探测,不支持时自动回退;daemon 会话语义、list_changed、ttlMs
  • e3 协议版本在 via servers/doctor 里可见,可用 protocolVersion 固定
  • e4 tasks、e5 elicitation(不声明 sampling)、e6 MCP Skills 扩展
  • e7 授权:CIMD、client credentials、凭证绑定授权服务器
  • e8 官方 conformance 套件进 CI;e9 completion 与 server 自述字段

0.6 借鉴与补齐:schema 快照校验、via 自身出站请求走 HTTPS_PROXY(现在这些变量只转发给 stdio 子进程)、daemon 与 stdio server 日志、-h 给出完整调用示例、via prompt 输出 SKILL.md

0.4 补充:d1 评测加 mcpc 作为可选对照列;d4 加 Homebrew;新增 d6 next: 提示的引号审计(参考 apify/mcpc#450)

不借鉴:本地代理做凭证隔离、x402、与协议一一对应的命令加显式会话、订阅资源写文件、--insecure

另外:vision 的对比表加入 mcpc,并更新 mcporter 一行;差异点的表述改为命名与渲染规则,不再是聚合;open-questions.md 新增三条(tasks/skills 的命令形态、server instructions 是否进视图、CIMD 文档托管在哪);两份 README 的对比链接文字加上 mcpc。

Checklist · 检查清单

  • npm run typecheck, npm test and npm run build pass — 只改了文档,没有运行
  • User-visible behavior changes update docs/spec/ and the Unreleased section of CHANGELOG.md — 没有行为变化;按 docs(roadmap): mark 0.1–0.3 status, record where the gates stand, plan 0.4 #16 的先例,路线图改动不写进 CHANGELOG
  • Rendering changes come with snapshot tests — 不涉及
  • Verb list, stopword and naming changes say in CHANGELOG which canonical names they affect — 不涉及
  • No resolved credential values in output, logs or snapshots

Generated by Claude Code

…d from mcpc (0.6)

- 0.5 is required work and can run alongside 0.4: move to the official
  TypeScript SDK v2 (v1 stops at 2025-11-25), support the stateless
  2026-07-28 protocol with automatic fallback, show and pin the
  negotiated version, tasks, elicitation, the Skills extension, CIMD and
  client-credentials OAuth, and the official conformance suite in CI
- 0.6 takes what fits via from apify/mcpc: schema snapshot checks,
  proxy support for via's own HTTP requests, daemon and stdio server
  logs, full call examples in -h, and a SKILL.md output for via prompt
- 0.4 gains mcpc as an optional comparison column in the benchmarks, a
  Homebrew formula, and an audit of quoting in next: hints (d6)
- A "not borrowed" list records what via leaves out on purpose
- The vision page compares via with mcpc and mcporter's runtime calls,
  and states that naming and rendering, not aggregation, are what set
  via apart; open questions gain the tasks/skills command shape, server
  instructions in views, and where the CIMD document is hosted

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016bCAHTTNtGTFAPNcsrjeS2
@github-actions
github-actions Bot merged commit 162790d into main Oct 21, 2026
6 checks passed
@github-actions
github-actions Bot deleted the claude/wonderful-cerf-fv8ydk branch October 21, 2026 13:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants