{
  "markdown": "# Lovision MCP Skills\n\n> Create, edit, inspect, preview, export, and hand off native Lovision designs from external agents.\n\nThis package is shaped like an external agent skill/plugin repository. It bundles:\n\n- [`lovision-mcp`](./skills/lovision-mcp/SKILL.md): the agent skill that teaches Claude, Cursor, Codex, Gemini CLI, VS Code, and other MCP-capable agents how to use Lovision MCP safely.\n- [`.mcp.json`](./.mcp.json): the remote Lovision MCP server config, registered as `lovision-remote`.\n- [`.claude-plugin/`](./.claude-plugin/), [`.cursor-plugin/`](./.cursor-plugin/), and [`gemini-extension.json`](./gemini-extension.json): editor-native plugin manifests.\n\nEvery install path should surface the same Markdown skill under [`skills/`](./skills/) and the same Remote MCP endpoint:\n\n```text\nhttps://mcp.lovision.ai/\n```\n\nLovision MCP is currently Early Access. If your client does not show a Lovision / OneAuth authorization flow after adding the server, confirm that Lovision has enabled MCP for your account and has provided the required authorization method.\n\n## Install\n\n### Claude Code plugin\n\n```bash\nclaude /plugin marketplace add choice-form/lovision-mcp-skills\nclaude /plugin install lovision\n```\n\nThe plugin registers the `lovision-remote` MCP server from [`.mcp.json`](./.mcp.json) and exposes the skill docs under [`skills/`](./skills/).\n\n### Claude Code skills only\n\nUse this when Lovision MCP is already configured and you only want the skill instructions:\n\n```bash\nnpx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a claude-code\n```\n\nManual MCP setup:\n\n```bash\nclaude mcp add --transport http lovision-remote https://mcp.lovision.ai/\n```\n\nThen run `/mcp` in Claude Code, select `lovision-remote`, and complete the Lovision / OneAuth authorization flow.\n\n### Cursor plugin\n\n```text\n/add-plugin choice-form/lovision-mcp-skills\n```\n\nCursor reads [`.cursor-plugin/plugin.json`](./.cursor-plugin/plugin.json), installs the skill, and registers the MCP server.\n\nSkills-only fallback:\n\n```bash\nnpx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a cursor\n```\n\nManual Cursor MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"lovision-remote\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.lovision.ai/\"\n    }\n  }\n}\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/choice-form/lovision-mcp-skills\ngemini /mcp auth lovision-remote\n```\n\nThe extension manifest registers Lovision MCP and enables OAuth.\n\n### Codex\n\nConfigure MCP:\n\n```bash\ncodex mcp add lovision-remote --url https://mcp.lovision.ai/\ncodex mcp login lovision-remote\n```\n\nThen add the skill with the skills CLI if your Codex environment supports it:\n\n```bash\nnpx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a codex\n```\n\n### Other agents\n\nFor hosts that do not understand plugin manifests, either use the skills CLI for that host or include the skill directly in the agent prompt:\n\n```markdown\n@include skills/lovision-mcp/SKILL.md\n```\n\nFor raw MCP clients, use [`.mcp.json`](./.mcp.json) as the Remote MCP server config.\n\n## Desktop Local MCP\n\nRemote MCP and Desktop Local MCP should be configured as two different MCP servers:\n\n- `lovision-remote`: `https://mcp.lovision.ai/`, uses Lovision / OneAuth login, and should initialize sessions with runtime `remote-web`.\n- `lovision-desktop`: copied from Lovision Desktop `Settings > MCP`, uses a local bearer secret, and should initialize sessions with runtime `desktop-local`.\n\nDo not hand-write the Desktop Local MCP authorization header. Open Lovision Desktop, go to `Settings > MCP`, enable Local MCP, then copy the actual Claude/Cursor/Codex config from that screen. The default URL is usually `http://127.0.0.1:3846/mcp`, but Desktop may choose another port if `3846` is occupied.\n\n## First Test\n\nAfter connecting, ask the agent:\n\n```text\nUse the lovision-remote MCP server. Initialize a Lovision session with runtime \"remote-web\". If projectId \"<projectId>\" is available, open that project first; otherwise list accessible projects and ask me which one to open. Then list available capabilities and summarize the project or page context. Do not modify the design yet.\n```\n\nFor a write smoke test after you confirm the target:\n\n```text\nUse Lovision MCP with projectId \"<projectId>\" to create a small frame named \"MCP smoke test\" on the current page, run a quality check, capture a preview, and summarize what changed.\n```\n\nThe agent should call `lovision.session.init` first and should use `lovision.capabilities.list` plus `lovision.document.getContext` before making edits.\n\n## Related Product Docs\n\n- Lovision MCP overview: `packages/docs/content/docs/mcp/overview.mdx`\n- Lovision MCP getting started: `packages/docs/content/docs/mcp/getting-started.mdx`\n- Lovision MCP tools: `packages/docs/content/docs/mcp/tools.mdx`\n",
  "bytes": 4844,
  "sha": "4d34a0eeb4fc7e7da0d838ef988fa25ad3d71ca29cde329c55f780f0ea900e0b",
  "repo_slug": "choice-form/lovision-mcp-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_choice_form_lovision_mcp_skills_58c10e32/readme"
}