
mcp-better
io.github.Wolfe-Jam由 GitHub 账号 Wolfe-Jam 发布v0.7.0更新于 Nov 19, 2026
Rust MCP textbook for 2026-07-28: annotated tools, MCP conformance suite in CI. AAIF contribution.
概览
一个可运行的 Rust MCP 教科书式服务器,面向 2026-07-28 协议,提供三个带注解的演示工具和技能文档,用于学习和测试 MCP 客户端。
- 可以做什么
- 用健康检查工具查看服务存活状态与协议版本
- 原样回显消息,作为纯演示
- 执行带调用中确认的回显,使用密封的请求状态
- 通过 Skills 扩展以资源形式读取技能文档
- 以 stdio 或可选的本地 Streamable HTTP 模式提供同一套接口
- 适用场景
- 适合需要一个精简、诚实的参考服务器来测试 MCP 客户端对 2026-07-28 协议的支持,观察工具注解、缓存提示和 Discover 行为的实际表现,或跟随配套教材学习。它不是生产力或数据处理工具。
- 运行要求
- 以本地进程运行。可用 cargo install 安装(需 Rust 1.88+,首次构建会编译依赖),或用 npx 试用,后者会下载原生二进制、无需 Rust 工具链。可选的 Streamable HTTP 模式默认绑定 127.0.0.1:8787,可用 MCP_BETTER_HTTP_ADDR 修改;传输方式可用 MCP_TRANSPORT 或 MCP_BETTER_TRANSPORT 设置。无需账号或 API 密钥。
安装
在 SourceWeft 中
- 打开 控制台中的 mcp-better,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
mcp-better — built for 7/28
NONE | GOOD | [BETTER] | BEST
Textbook for AGENTS.md on that scale — honest modern MCP at the BETTER step.
(protocol 2026-07-28 — the modern MCP release)
Modern MCP textbook that runs, reviewed and approved as an AAIF Ambassador contribution. Rust · rmcp 3.10 · Discover · stamped cache hints · the official MCP conformance suite in CI: 100% for the conformance build, and for the textbook binary every scored check except those that need a suite fixture or an undeclared method.
Book: textbook/ — what · why · how · doctrine.
App: this binary + smokes. Lesson after lesson, version after version — knowledge compounds.
BEST (BETTER plus
project.fafthat is resident and used: persistent project context that authors the agent files) lives at faf.one/agents, one hop up from this textbook.
Dual-package (optional)
We are Cargo. Install is cargo install. npx is a try path. We do not offer npm install as an option.
→ Why dual-package — positioning + FAQ
→ Full guide (how) — lockstep, publish order, OIDC, score + wire
Skills over MCP (optional · textbook)
One Agent Skill (mcp-better-lab) on the same process as tools:
→ docs/SKILLS-OVER-MCP.md — extension · skills/list · skills/get · digests
What is 7/28?
7/28 is a great name. 2026-07-28 is a date.
Humans say 7/28. Machines negotiate 2026-07-28.
What to expect
- Built for 7/28 — not bolted onto a legacy server (official
rmcp3.10). - Honest surface — transport and capabilities match docs and CI.
- Roadmap expands the era — versions add road; they do not “become” 7/28 later.
What BETTER means
- Protocol honesty — claim 7/28 /
2026-07-28only for surfaces you implement and test. - Discover-compatible — clients should use
ClientLifecycleMode::Discover(or Auto → 7/28), not only legacy initialize. - Cache hints by choice —
server/discover,tools/list,resources/list,resources/templates/list,resources/read,skills/listandskills/getreturn a positivettlMsandcacheScope(static catalog →public). The SDK default isttlMs: 0+private: valid, but it tells every client not to cache. - Stable tool order — same process, same order across N list calls.
- Annotated tools — every tool sets
readOnlyHint,destructiveHint,idempotentHintandopenWorldHint. A tool with no hints gets the spec's defaults: it may write, may destroy, and reaches the outside world. - Transports — stdio (default) and Streamable HTTP (
--http) in the same 7/28 era.
Quickstart (≤10 min)
Try (suggested) — npx
From source / crates.io (Rust 1.88+)
Install (crates.io) — stdio default (Cursor / Claude Desktop):
First cargo install compiles Rust deps once (often 100+ units — rmcp / tokio / …, not 100 tools of ours). One-time; then the binary is instant. To skip that compile, try with npx mcp-better (above) — that is not the install.
Streamable HTTP (local demo only — see SECURITY.md):
Transport selection (CLI wins over env):
Tools
All three are annotated readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false: they read only, change nothing and stay in the process.
Protocol claims (v0.7.0 — same 7/28 era · the official conformance suite in CI)
Conformance
CI runs the official MCP conformance suite (@modelcontextprotocol/conformance, pinned) against two binaries. Each run covers --requirements 2026-07-28 (50 scenarios: 37 the suite scores, 13 it runs but does not score) and the two Skills scenarios (sep-2640-skills-enumeration, sep-2640-skills-manifest, an extension outside that set).
What each run measures. Most scenarios call tools, prompts and resources that exist only in the suite's reference server (test_*, test://…), and the 13 unscored ones are the Tasks extension and three pending scenarios. The official SDKs pass those with a separate server that carries the fixtures; mcp-better-conformance is that server for mcp-better. Its fixtures, capabilities and Tasks are adapted from the Rust MCP SDK's conformance server (Apache-2.0, conformance/NOTICE); BetterServer serves mcp-better's three tools, the skill resource and Skills. So the 100% mostly measures the fixtures and the shared transport (mcp_better::http_config). The textbook run and the Skills scenarios measure mcp-better's own code.
Reading the textbook run. caching is 7 of 8: the eighth check calls prompts/list, and mcp-better doesn't declare prompts, so it answers method-not-found (not declared in the baseline). prompts-list and completion-complete fail for the same reason. Every other failure is a missing suite fixture. The suite's MRTR scenarios use its own fixture tools, so confirm_echo is checked by the matching client (examples/mrtr-client), which declares elicitation, and by a handler test that a client without it gets -32021 (missing required client capability).
Textbook
The book is the app is the book — textbook/ (Season 1 · doctrine).
Start: textbook/README.md → lab Ch 09.
Non-goals (GOOD-era habits we refuse)
- Shipping unstamped list results while claiming 7/28 modernity
- Requiring
project.fafor any BEST tooling on this repo’s main branch - Treating stdio as “not real 7/28” — stdio is a first-class 7/28 transport
- FAF install tax in the AAIF lede — this repo is protocol textbook, not a FAF product
Registry identity
- MCP Registry name:
mcp-name: io.github.Wolfe-Jam/mcp-better - Dual packages (same version, both stdio):
registryType: cargo ·identifier:mcp-better· crates.ioregistryType: npm ·identifier:mcp-better· registry.npmjs.org
(Node shim downloads the native binary from GitHub Releases — no Rust on the host)
- Package transport in
server.jsonis stdio only — by design.
Hosts spawn viacargo install/npx mcp-betteron stdio.
Streamable HTTP (--http) is an opt-in local demo in the same binary and the same 7/28 era; it is not a Registry remote package. Discover it in this README and--help.
See server.json. Not one.faf/*.
Publish
Ship process: /pubbetter (skill) · short form docs/PUBBETTER.md · local ship bar:
The ship bar needs Node 18+ and network: it fetches the official MCP conformance suite with npx (pinned version) and, if installed, runs rust-mcp-preflight on server.json (it reads crates.io and the MCP Registry).
BEST
For persistent, versionable AI project context beyond a protocol textbook:
Docs
- BETTER.md — ladder + claim surface
- docs/BETTER-BEST.md — BETTER vs BEST
- GETTING-STARTED.md
- docs/SDK-NOTES.md —
servevs Discover honesty - docs/DUAL-PACKAGE-FOR-RUST-MCP.md — why dual-package (cargo first · FAQ)
- docs/DUAL-PACKAGE-RUST-MCP.md — how: full dual cargo+npm guide
- docs/MCP-DIST-POST.md — lockstep post-step (does not publish)
- SECURITY.md · CONTRIBUTING.md
License
MIT — see LICENSE. Except conformance/ (the unpublished conformance build), which is Apache-2.0: see conformance/NOTICE.
来源:README.md,提交 bfa76f0
工具
0版本历史
3- v0.7.0最新Nov 19, 2026
- v0.6.0Nov 16, 2026
- v0.5.0Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分