ouicu

Name: ouicu
Author: ouicu.com

本地服务

ouicu.com云与基础设施03 周前更新

代码仓库访问官网

关于 ouicu

ouicu 是面向编码 Agent 的 MCP 服务，可分享正在运行的开发服务器，或发布构建后的网站并返回链接。其工具还可管理分享和站点、查看近期请求与用量，并支持密码保护或仅限受邀者访问。

主要功能

01通过公开链接分享运行中的端口
02将构建目录部署为长期链接
03列出、停止和删除分享或站点
04查看近期请求和月度用量
05通过密码或邀请名单限制访问
06通过浏览器批准完成登录

适用场景

01分享开发预览以供审阅
02发送已构建落地页的链接
03将临时预览限制为受邀者访问
04检查共享站点的近期请求

MCP 相关

MCP 服务通过 stdio 向 MCP 客户端提供 ouicu 分享、部署和账户管理工具。它使用 ouicu CLI 分享端口，并读取已保存的登录凭据或发起浏览器批准流程。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "com-ouicu": {
      "command": "npx",
      "args": [
        "-y",
        "@ouicu/mcp"
      ],
      "env": {
        "OUICU_API_KEY": "<OUICU_API_KEY>"
      }
    }
  }
}

启动命令npx -y @ouicu/mcp

需要配置的环境变量

OUICU_API_KEY密钥A ouicu API key. Optional: without one the server uses the login `ouicu login` saved, or offers to log in.

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

安装包

npm@ouicu/mcp0.1.2stdio

工具

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

参数	类型	必填	说明
wait	integer	否	批准前等待的秒数（60）。

详细介绍

@ouicu/mcp

适用于 ouicu 的 MCP 服务。编码 Agent 可以分享正在使用的开发服务器，或发布构建好的网站，并返回一个链接供他人访问：只需一轮对话，就能完成“构建落地页并把链接发给我”。

设置

npx -y @ouicu/mcp setup claude-code

或使用 claude-desktop、cursor、vscode、codex、windsurf。如果这台计算机尚未登录 ouicu，它会先为你登录：显示一个代码，在浏览器中打开 ouicu.com 供你批准，并将密钥保存到 ouicu CLI 存放密钥的位置。然后，它会为所有项目将服务添加到工具中。密钥不会写入工具的设置；服务会从凭据文件中读取密钥，因此 ouicu login 和服务共用同一个登录状态。

如果缺少工具自己的命令（claude、codex），它会打印需要手动运行的命令。对于 Claude Code，命令如下：

claude mcp add -s user --transport stdio ouicu -- npx -y @ouicu/mcp

其他 MCP 客户端会以 npx -y @ouicu/mcp（stdio）的方式启动服务：

{
  "mcpServers": {
    "ouicu": { "command": "npx", "args": ["-y", "@ouicu/mcp"] }
  }
}

分享端口还需要 ouicu CLI，版本为 0.1.7 或更高（仅与受邀人员分享则需要 0.1.8）：

curl -fsSL https://ouicu.com/install.sh | sh

在 Windows 上，使用 PowerShell：

irm https://ouicu.com/install.ps1 | iex

工具

工具	功能
`ouicu_share_port`	在服务运行期间通过公开链接分享端口（port、name?、password?、allow?）
`ouicu_stop_share`	按名称、ID 或链接停止分享，无论分享位于此处还是账户中的其他位置
`ouicu_list_shares`	优先列出正在分享的项目，然后列出最近结束的项目
`ouicu_deploy`	将构建好的文件夹发布到长期有效的链接（directory、name?、spa?、password?）
`ouicu_list_sites`	账户中的网站
`ouicu_delete_site`	删除网站及其文件
`ouicu_recent_requests`	查看对分享链接或网站的最新访问请求：谁打开了它，以及哪些请求失败了
`ouicu_usage`	查看本月数据用量与套餐额度的对比
`ouicu_whoami`	账户和套餐信息

每个工具都会以文字形式给出结果，便于 Agent 转述，同时也会提供相同内容的结构化数据。链接是公开的：任何拥有链接的人都可以打开，除非链接设有密码或仅限受邀人员访问。使用 Free 套餐时，访客在浏览器中打开链接后，会先看到 ouicu 显示的一条简短提示，说明是谁分享了链接。

服务启动的分享会通过 CLI 在服务内部运行，并会在服务停止时结束；也可以使用 ouicu_stop_share 停止分享。若要创建在会话结束后仍然有效的链接，请使用 ouicu_deploy。

仅限受邀人员

Pro 套餐支持在 ouicu_share_port 中设置 allow：可以填写电子邮件地址，也可以填写 @ 加域名（例如 @client.com），以允许该域的所有人员访问。只有这些人员可以打开链接。ouicu 不会向他们发送链接；你需要像分享其他链接一样自行发送。打开链接时，每个人都需要在 ouicu 页面上输入自己的电子邮件地址；如果地址在列表中，就会收到一封包含登录链接的电子邮件。你自己的地址始终可以访问。allow 不能与 password 同时使用。只有受邀人员可以打开分享链接时，工具会给出提示；ouicu_list_shares 和 ouicu_list_sites 也会对这些项目显示“仅限受邀人员访问”。

如果服务器已经在分享某个端口，再次请求该端口时，只有在可访问人员相同（任何人、相同密码或相同名单）时才会返回现有分享；否则，工具会提示先停止现有分享。

未配置密钥时

服务启动时只提供一个工具：ouicu_login。如果可以，它会在用户的浏览器中打开批准页面（否则会返回代码和地址，供 Agent 转达），并等待用户批准。之后，其他工具会自动出现，无需重启。当已保存的密钥失效时，ouicu_login 会重新出现。

设置

服务会读取 OUICU_API_KEY（来自 ouicu.com 的密钥，而非已保存的登录信息）、OUICU_API（指向 ouicu.com 以外的另一个 ouicu）、OUICU_TUNNEL 和 OUICU_BIN（要运行的 CLI）。代码如下：

import { createServer } from "@ouicu/mcp";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

await createServer().connect(new StdioServerTransport());