★ FEATURED ARTICLE 【免费下载链接】WebMCPEarly WebMCP proposal / implementation - since evolved and worked on by much more capable folks that develop the web: https://github.com/webmachinelearning/webmcp项目地址https://gitcode.com/gh_mirrors/we/WebMCP点击查看免费下载WebMCP CLI命令是使用 WebMCP 的全部入口。WebMCP 是一个让任意网站把 tools、resources、prompts 共享给你本地 LLM 客户端Claude Desktop、Cursor、Cline、Windsurf 等的开源项目它通过一个只运行在 localhost 的 WebSocket 桥接服务器默认端口 4797实现连接。这篇文章就是它的WebMCP CLI 命令完全指南8 个开关逐个讲清楚新手照着敲命令即可上手。一、WebMCP CLI 是做什么的先用一句话理解它的工作方式MCP 客户端 → MCP Server → WebSocket Server → 你的网页工具在这里执行→ 结果按原路返回也就是说CLI 命令负责三件事搭建本地桥接服务后台常驻的 WebSocket 服务器向 MCP 客户端写配置把 WebMCP 注册进你的 AI 工具签发一次性连接令牌把网站接进来所有命令都通过npx直接运行无需提前安装npx -y jason.today/webmcplatest [选项]二、8 个 CLI 开关总览表以下清单来自源码中的参数解析逻辑 src/websocket-server.js| 短参数 | 开关 | 作用 | 常见场景 | | :--: | :--: | -- | -- | | — |--config| 自动把 WebMCP 写入 MCP 客户端配置 | 首次安装最常用 | |-p|--port| 指定端口号默认 4797 | 端口冲突时 | |-q|--quit| 停止后台服务 | 关闭 WebMCP | |-n|--new| 生成新的网站连接令牌 | 接入一个网站 | |-c|--clean| 清除所有已授权令牌 | 重新开始时 | |-f|--foreground| 前台运行不转入后台 | 调试、看日志 | |-m|--mcp| 启动内置 MCP Server | 写在客户端配置里 | |-d|--docker| 声明服务跑在 Docker 里 | 容器部署 | |-h|--help| 显示帮助信息 | 忘了参数时 |三、逐个开关详解1️⃣--config一键配置 MCP 客户端最常用首次使用只需要这一条命令WebMCP 会自动找到对应客户端的配置文件并写入连接信息npx -y jason.today/webmcplatest --config claude内置支持 4 种客户端claude、cline、cursor、windsurf。如果传入的不是这四个名字程序会把它当作一个JSON 配置文件的路径来处理因此任何支持 MCP 配置格式的工具都能接入。 注意部分客户端如 Claude Desktop写入配置后需要重启才能看到新工具。客户端配置路径映射逻辑见 src/config.js。2️⃣--new生成网站连接令牌要让某个 WebMCP 网站接入你的 AI需要一张入场券——连接令牌npx -y jason.today/webmcplatest --new命令会输出一段CONNECTION TOKEN把它粘贴到网站右下角蓝色小方块提供的输入框中即可。这张令牌是一次性的网站用它注册后立即作废网站会拿到自己独立的会话令牌。也可以直接让模型替你调用内置的令牌生成工具效果相同如果你不想让模型看到令牌内容就手动执行--new。令牌生成逻辑见 src/websocket-server.js。3️⃣--mcp启动 MCP Server写给客户端配置的这个开关一般不用你手动敲它由--config自动写入客户端配置。写入的内容形如npx -y jason.today/webmcplatest --mcp作用是以 MCP Server 身份常驻等待 AI 客户端通过本地端口连入。手动体验完整流程可以执行npx -y jason.today/webmcplatest --mcp4️⃣--port修改监听端口默认端口是4797。如果你的电脑上该端口被占用Docker 部署时同理见 docker-compose.yml可以换一个npx -y jason.today/webmcplatest --port 8080端口必须是 1~65535 之间的数字否则命令会报错退出。5️⃣--quit停止后台服务WebMCP 默认以守护进程daemon方式在后台运行通过 PID 文件管理。要关闭它npx -y jason.today/webmcplatest --quit没有运行中的服务时会提示No running server found不用担心报错。停止逻辑见 src/websocket-server.js。6️⃣--clean清除所有已授权令牌当你想推倒重来比如换了一台电脑、或网站授权混乱了npx -y jason.today/webmcplatest --clean该命令会清空本地保存的全部频道-令牌配对。如果服务正在运行需要再重启一次服务才能生效。令牌存储逻辑见 src/tokens.js。7️⃣--foreground前台运行默认情况下服务会 fork 到后台。加上--foreground或短参数-f则不进入后台方便你直接看到实时日志、按 CtrlC 结束npx -y jason.today/webmcplatest --foreground调试端口冲突、连接失败等问题时这是最实用的开关。8️⃣--docker声明 Docker 部署如果你用容器方式跑 WebSocket 服务器项目自带 Dockerfile 和 docker-compose.yml在客户端配置中同时加上--dockerWebMCP 会认为服务已在容器里运行直接通过 WebSocket 连入而不是再启动一个本地进程。四、速查典型操作命令清单把下面几段收藏起来日常基本够用| 操作 | 命令 | | -- | -- | | 首次安装以 Claude 为例 |npx -y jason.today/webmcplatest --config claude| | 生成网站令牌 |npx -y jason.today/webmcplatest --new| | 换端口启动 |npx -y jason.today/webmcplatest --port 8080| | 前台调试 |npx -y jason.today/webmcplatest --foreground| | 清除所有授权 |npx -y jason.today/webmcplatest --clean| | 停止服务 |npx -y jason.today/webmcplatest --quit| | 查看帮助 |npx -y jason.today/webmcplatest --help|等价的原生node启动方式见 package.json 中的 scriptsstart-daemon、stop-daemon、start-mcp-client等。五、配置存在哪里所有配置统一存放在用户主目录的~/.webmcp下目录创建与文件定义见 src/config.js.webmcp-server.pid后台服务的进程号.env自动生成的服务器内部令牌.webmcp-tokens.json所有已授权网站的频道-令牌记录需要干净重装时执行--clean--quit即可无需手改这些文件。六、新手常见问题Q1令牌可以重复使用吗不行。--new生成的注册令牌在网站完成注册后立即销毁每个网站只对应一张会话令牌。Q2为什么 AI 里看不到新网站的工具依次检查① 网站页面是否显示已连接绿勾状态② MCP 客户端是否重启过③ 用--foreground看日志确认服务在运行。Q3连接会自动断开吗会。网页端 5 分钟无操作会自动断开并收起面板属于安全设计超时逻辑见 src/webmcp.js。Q4这个项目符合 W3C 官方规范吗需要注意本仓库是 WebMCP 的早期提案实现用于验证网站即 MCP 服务器的价值并不符合后来演进出的 W3C 官方规范。完整背景说明见 README.md。写在最后掌握--config安装、--new接网站、--quit退出三个高频开关WebMCP 的核心使用流程就跑通了其余 5 个开关--mcp、--port、--clean、--foreground、--docker分别对应调参与运维场景按需查阅即可。祝使用愉快赞分享【免费下载链接】WebMCPEarly WebMCP proposal / implementation - since evolved and worked on by much more capable folks that develop the web: https://github.com/webmachinelearning/webmcp项目地址https://gitcode.com/gh_mirrors/we/WebMCP点击查看免费下载相关推荐Chalice CLI命令完全清单new-project、deploy、delete等15条命令一次讲透Chalice CLI命令完全清单new project、deploy、delete等15条命令一次讲透 本文完整梳理 Chalice CLI 的 15 条核后端云原生WeClaw微信命令完整清单/cc、/new、/cwd等12个实用命令全解析WeClaw微信命令完整清单/cc、/new、/cwd等12个实用命令全解析 WeClaw是一款微信AI Agent桥接器让你通过微信聊天直接驱动ClaudConversation Stenography 用户手册/paste、/send、/status 等 8 个聊天命令完全清单Conversation Stenography 用户手册/paste、/send、/status 等 8 个聊天命令完全清单 Conversation St创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
