ouicu

Share a dev server or upload a built site at a public https link, and hand the link back.

OtherTypeScriptv0.1.2

ouicu for JavaScript: SDK and MCP server

ouicu gives the site running on your computer a public https link, like https://studiolund.ouicu.app, so a client or teammate can open it on any phone or computer. This repository holds ouicu's two npm packages:

PackageWhat it does
@ouicu/mcpAn MCP server: Claude Code, Cursor, Codex and other coding agents share your dev server or upload a build and hand you the link.
@ouicu/sdkouicu from Node: share a port, upload a built site, list shares and sites, see who opened them.

MCP server

npx -y @ouicu/mcp setup claude-code

The same works for cursor, codex, vscode, windsurf and claude-desktop. Then ask your agent for a link in your own words, for example "build the gallery page and send me a ouicu link". The agent shares the dev server, or uploads the build, and hands back the address.

It is listed in the official MCP Registry as com.ouicu/mcp. Docs: ouicu.com/docs/mcp. More in packages/mcp.

SDK

npm install @ouicu/sdk
import { Ouicu } from "@ouicu/sdk";

const ouicu = new Ouicu({ apiKey: process.env.OUICU_API_KEY });
const share = await ouicu.share({ port: 3000, name: "studiolund" });
console.log(share.url); // https://studiolund.ouicu.app

Node 20 or later, no other dependencies. Docs: ouicu.com/docs/sdk. More in packages/sdk.

What ouicu is for

Showing work in progress to people who aren't developers: a reserved name keeps the same link for each client, a password or a list of invited people keeps it private, you get an email when someone opens it, and the last version stays up while your laptop sleeps. It passes web pages (HTTP and WebSockets), not TCP, video or downloads. Plans and limits: ouicu.com/docs/plans.

The ouicu command line tool itself is installed from ouicu.com; its releases are at kroqdotdev/ouicu-cli.

About this repository

These packages are developed in ouicu's main repository and copied here on every change, so this history is a series of snapshots. Issues are welcome here; for a change, open an issue or a pull request and it will be made upstream. Questions: hello@ouicu.com.

pnpm install
pnpm build
pnpm test

MIT licensed. See LICENSE.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @ouicu/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@ouicu/mcpnpm

Compatible MCP Clients

ouicu works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More