开发者实测：把本地 MCP 服务器打包成 Claude Desktop 一键扩展

sarghayk · reddit · 2026-10-24

开源 Mac 会议记录应用 Griasa 的作者分享了将本地只读 MCP 服务器打包为 .mcpb 桌面扩展的完整经验。由于 Claude Desktop 的远程连接器从 Anthropic 服务器发起，无法访问仅监听 localhost 的服务，作者改用桌面扩展方案，并总结出多条踩坑心得：

桥接层极简：用 Node stdio↔HTTP bridge，每条消息都从 JSON 文件重读 URL 和 token，token 更换或应用重启都不会断连
提供静态工具列表：应用未运行时 Claude Desktop 仍能看到工具并返回友好提示，而非扩展失效
每个工具标注 readOnlyHint，同时返回 structuredContent 与文本
同时兼容新旧协议版本：最新 spec 是无状态的，但 Claude Code、Codex、Cursor 仍在用旧版
1.0.20 起发布脚本自动从签名应用构建 .mcpb、附到 GitHub Release，并向官方 MCP Registry 发布 server.json（含 sha256），保证目录站列出的与用户安装的完全一致；目录站还要求本地服务器提供隐私政策

整个应用数据不出本机、无账号无遥测，端点默认关闭、仅 localhost 且 token 保护。可用 brew install --cask stari-am/tap/griasa 安装。

「编程与Agent」频道最新