mcpField
S
serve

serve

本地服务
servelink.cc云与基础设施07 周前更新

关于 serve

serve 是一项托管服务,让 Agent 为本地服务或托管的文件与应用创建公开链接。其 MCP 接口可管理链接、设置密码保护并撤下分享;同一链接可在实时隧道和托管内容之间切换。

主要功能

  1. 01通过隧道分享本地服务
  2. 02托管文件和应用
  3. 03在实时访问与托管间切换链接
  4. 04通过 Agent 管理链接
  5. 05可选密码保护

适用场景

  1. 01编辑本地应用时分享给他人
  2. 02发布供客户稍后查看的演示文稿
  3. 03电脑离线时仍保持链接可用
  4. 04完成后撤下正在分享的内容

MCP 相关

serve 提供 MCP 服务,供 Agent 创建和管理公开链接、设置密码保护及撤下分享。它将 Agent 连接到托管服务和本地客户端,以支持隧道链接。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"cc-servelink-serve": {
"command": "npx",
"args": [
"-y",
"@servelink/serve"
]
}
}
}
启动命令npx -y @servelink/serve

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@servelink/serve0.8.8

工具

17

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

serve

你已经会让 AI 制作东西。现在,让它把东西分享出去。

smithery badge

you:      "serve me this"
Claude:   → https://lively-bison-4821.servelink.cc

这就是 serve。你说一句话,刚刚制作的东西就会有一个真实的 URL——你可以发短信给朋友、贴到 Slack 讨论串里,或者放到幻灯片上。无论你制作的是 Next.js 应用,还是让它生成了销售演示文稿,效果都一样,因为 serve 不在乎你制作的是什么。它只在乎你想让别人看到它。

**serve 是一项托管服务。**创建账户、登录一次,你的链接就会位于 *.servelink.cc。

**关于此代码库。**这里是 serve 的公开目录和配置中心:MCP 注册表清单、Claude Code 插件清单,以及用户文档。serve 是一项商业托管服务,其实现代码库为私有。使用 serve 所需的一切都在这里或 npm 上——无需构建,也无需编译这里的任何内容。


链接可以存在于两个地方

每个 serve 链接要么通过你的设备实时提供,要么由我们持续托管。

  • **通过你的设备实时提供。**链接指向此刻正在你电脑上运行的内容。更改标题,持有链接的人就会看到新标题。合上笔记本电脑,链接就会暂时无法访问。(底层使用隧道;你的 Agent 会为你打开隧道。)
  • **由我们持续托管。**我们会在 serve 的服务器上保存一份副本。即使你的笔记本电脑关机、休眠,或者装在机场的包里,链接仍然可以打开。

你不必预先选择,也不会被选择所束缚。“分享这个,让队友在我制作时可以查看”会采用第一种方式。“让它一直在线,这样他们明天也能读”会采用第二种方式。同一个链接、同一个 URL,只需一句话就能切换。

这个切换功能是人们意想不到的地方。其他地方,“让别人看看我笔记本电脑上的内容”和“把这个放到互联网上”是两种不同的产品,需要两套不同的设置,在两者之间切换更是一项工程。而在这里,它们只是同一个请求的两种说法。

你无需操作——你的 Agent 会代劳

serve 真正的界面不是终端,而是 MCP——AI Agent 已经在使用的协议。这意味着,创建链接不是你要专门去做的任务,而是你随口提起的一件事。你的 Agent 会创建链接、告诉你 URL、在你提出要求时为链接设置密码,并在你完成后将其关闭。serve 也提供 CLI,而且很好用,只是留给你想手动操作时使用。

这也是 serve 不只面向开发者的原因。如果你能让 Claude 为你制作仪表板,就能让 Claude 把它的链接交给你。分享内容所需的技能,正是你制作它时已经用到的技能。

快速开始

npm i -g @servelink/serve     # npm is the primary channel
serve login                   # opens your browser to confirm

然后告诉你的 Agent 它已经安装好了。任何支持 MCP 的客户端都可以——Claude Code、Claude Desktop、Cursor、opencode:

{
  "mcpServers": {
    "serve": {
      "command": "npx",
      "args": ["-y", "@servelink/serve"]
    }
  }
}

设置就这么简单。接下来只需对话:索要链接,获取链接。

如果你使用 npm i -g 全局安装,不带 args 的 "command": "serve" 也可以正常工作,而且启动速度会稍快一些。

更喜欢 Homebrew?

brew install servelink-swyftlabs/tap/serve

一个账户可以在任意多台设备上使用。

Claude Code 插件

此代码库同时也是 Claude Code 插件市场,因此你可以跳过 JSON:

claude plugin marketplace add servelink-swyftlabs/serve-mcp
claude plugin install serve@servelink

或者在试用期间,让 Claude Code 使用本地克隆:

claude --plugin-dir ./serve-mcp

此插件会通过 .mcp.json 提供 MCP 服务配置,仅此而已——没有钩子、没有 Agent,也没有任何会在你的设备上运行的代码,serve 客户端本身除外。

你可以直接提出的需求

这些都不是命令,而是人们平时真的会说的话,Agent 会自行判断如何处理。

“把这个提供出来,这样我就能在手机上查看了。”

“把演示文稿放到我的客户能打开的地方,并设置密码保护。”

“这个链接会放进邮件里,所以确保下周还能用。”

“关闭我现在打开的所有内容。”

“我现在正在分享什么?”

Agent 会据此判断链接应该从你的机器还是我们的机器提供服务,注册子域名,设置保护措施,并告诉你它做了什么。如果你提出的需求超出了套餐范围,它会直接说明,而不是只完成一半。

你将获得

  • 永久归你所有的链接。 链接从创建那一刻起就归你所有——永不回收、永不移除,也不会为了腾出空间而过期。过一周重新连接,URL 仍然相同,所以别人留下的标签页依然能用。
  • 可以直接念出来的名称。 每个链接都会获得类似 lively-bison-4821 的名称,而不是哈希值。Pro 用户可以指定名称,例如 goldenfish.servelink.cc。
  • 随时设置密码(Pro),适用于任何链接,期限可设为一小时或一个月。撤销密码后,已经在访问的人会立即被挡在外面。
  • 真正的应用,而不只是静态文件。 支持流式响应、服务器发送事件、WebSocket、大型下载,以及现代页面加载时发出的十几个并行请求。
  • 无论身在何处都能使用。 你的机器会向外发起连接,因此家庭 NAT、办公防火墙和酒店 WiFi 都不成问题。无需开放入站端口、配置路由器,也不用找 IT 部门。
  • 免费套餐包含明确的额度——每月 2 GB 流量,同时最多提供 3 个活动链接——而不是让你之后才发现费用超标的计量方式。

底层采用端到端 QUIC,并具备按流量控制和真正的反压机制;只有本地服务器确实接受连接后,WebSocket 升级才会报告成功。

Free 与 Pro

有两个词值得先说清楚,因为套餐就是围绕它们设计的。链接是归你所有的 URL。隧道是当前处于活动状态的链接。无论使用哪个套餐,你都可以拥有任意数量的链接;套餐限制的是同时运行的链接数量,以及它们承载的流量。

FreePro
价格$0$9.99/月
自有链接数无限无限
同时活动数310
单次发布最大容量100 MB1 GB
存储总量1 GB50 GB
每月流量2 GB25 GB
已发布链接的访问次数无限*无限*
密码保护—任意链接,任意期限
自选子域名—是
分析打开次数打开次数、字节数、来源页面、国家/地区
每小时 / 每日发布次数30 / 100300 / 1,000

* 每个链接的访问次数没有上限,也没有按访问者计算的带宽配额。如果整个服务的流量可能导致每月基础设施预算超支,serve 可能会暂停新请求,直到额度重置。达到上限不会删除任何内容——你的链接及其中的所有内容仍然归你所有。

serve 的对比

隧道工具负责传输字节,其中少数工具会限制或按量计费。没有哪个工具会在前面加上一段对话。

servengrok 免费版Cloudflare TunnelTailscale
面向所有人的公共 HTTPS URL是是是仅 Funnel¹
由你的 Agent 驱动(MCP)是否否否
可托管内容,也可建立隧道是否否否
免费稳定子域名是付费——
免费流式响应是付费——
标明限制的免费套餐是按量计费受限—
位于 NAT 后,无需开放端口是是是是

¹ Tailscale 为你提供专用网状网络,让你的设备彼此连接。要把 URL 交给网络之外的人,需要使用单独的功能 Funnel。

不过,这些条目还不足以体现它的优势。在其他工具中,“让别人看到我的笔记本电脑”和“妥善托管内容”是两种不同的产品,你需要二选一。而在这里,它们只需一个链接和一个设置,而设置只要一句话。

安全性,以及一件你应该了解的事

  • 你的设备与你的账户绑定。 serve login 会运行 OAuth 2.0 设备授权流程,且中继只接受来自已属于你的密钥的链接。
  • 每个请求都经过签名。 你的机器会在 ~/.serve/identity 中保存一个 Ed25519 密钥(权限模式为 0600),用于为每次注册和绑定签名。子域名归属于该密钥,因此其他人无法认领它,也无法让正在运行的隧道离线——仅仅知道你的 URL 还不够。
  • 撤销会立即生效。 在控制面板中撤销设备后,新的绑定会立即停止;撤销信息到达中继时,正在运行的隧道也会断开。
  • 中继会终止 TLS。 这一点我们宁愿由我们亲自告诉你:由于 serve 的中继会提供 *.servelink.cc 的证书,因此可以以明文形式查看隧道流量。请勿通过隧道传输生产环境机密,或任何你不希望我们在技术上能够看到的内容。已发布(托管)的链接是你主动交给我们的文件,因此按定义也适用同样的情况。
  • 仅支持 QUIC、UDP 443,不提供回退。 如果你的网络阻止出站 UDP,serve 会明确报错,而不会降级运行。运行一条命令 serve doctor 即可了解原因。

文档

  • 入门指南 — 从安装到创建第一个链接的完整指南
  • CLI 参考 — 每条命令、对应的标志和配置优先级
  • MCP 工具 — 全部 17 个工具,以及它们的结果包含哪些内容
  • 预览模式 — 生产环境与 HMR,以及如何解读 WebSocket 故障
  • 故障排除 — 或者直接运行 serve doctor
Viewer → HTTPS → relay (QUIC edge, UDP 443)
                    │
                    ▼
           relay coordinator (hosted)
                    ▲
                    │ QUIC streams (ALPN serve-tunnel/2)
                    │
          your machine → localhost:PORT

你的客户端会向托管的控制平面注册,然后通过 UDP 443 向外拨号,因此无需开放入站端口。查看者请求和 WebSocket 会映射到专用 QUIC 流,并采用端到端背压机制。Transport v2 仅支持 QUIC,不提供 WebSocket 回退,也不会降级到 HTTP/2,因此版本不匹配时会明确失败,而不会悄悄重试。

此仓库包含的内容

README.md              what you're reading
server.json            MCP registry manifest (cc.servelink/serve)
.claude-plugin/        Claude Code plugin + marketplace manifests
.mcp.json              MCP server configuration the plugin installs
docs/                  user documentation
LICENSE                proprietary notice

不包含产品源代码。serve 客户端以签名二进制文件的形式通过 npm 和 Homebrew 分发;中继、账户 API 和 worker 均为托管组件。

链接

许可证

专有软件 — 保留所有权利。请参阅 LICENSE。此仓库中的文档和清单均已发布,以便 serve 能够被列出、安装和了解;此类发布并不授予任何有关 serve 软件或服务的权利。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。