跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

capacitor-mcp

Guides the agent through connecting an MCP client to the hosted, unofficial Capacitor MCP server by Capawesome, which serves the official Capacitor documentation for v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog. Covers client detection, setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and stdio-only clients, documentation version selection, verification, and troubleshooting. Do not use for installing or configuring Capacitor plugins, upgrading or migrating apps and plugins to a newer version, Ionic Framework UI components, Capawesome Cloud, or MCP servers other than the Capacitor one.

capawesome-team · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add capawesome-team/skills --skill capacitor-mcp

技能说明


name: capacitor-mcp description: "Guides the agent through connecting an MCP client to the hosted, unofficial Capacitor MCP server by Capawesome, which serves the official Capacitor documentation for v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog. Covers client detection, setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and stdio-only clients, documentation version selection, verification, and troubleshooting. Do not use for installing or configuring Capacitor plugins, upgrading or migrating apps and plugins to a newer version, Ionic Framework UI components, Capawesome Cloud, or MCP servers other than the Capacitor one." license: MIT compatibility: "Designed for MCP clients such as Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, and Zed. Requires network access to https://capacitor-mcp.capawesome.io. No account and no token. Stdio-only clients additionally require Node.js 22 or later." metadata: author: capawesome-team source: https://github.com/capawesome-team/skills/tree/main/skills/capacitor-mcp

Capacitor MCP Server

Connect an MCP client to the hosted Capacitor MCP server for the current Capacitor documentation, the official and community plugin list, and the Capacitor posts from the Ionic blog.

The server is hosted by Capawesome — there is nothing to install, no account, and no token:

https://capacitor-mcp.capawesome.io/mcp

This is an unofficial server. It is maintained by Capawesome and is not affiliated with or endorsed by Ionic or OutSystems. It serves the official Capacitor documentation, © the Ionic team and licensed under Apache-2.0.

Prerequisites

  1. An MCP client: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, or any other client that implements the Model Context Protocol.
  2. Network access to https://capacitor-mcp.capawesome.io.
  3. For clients that only start local commands: Node.js 22 or later.

Agent Behavior

  • Guide step-by-step. Walk the user through the process one step at a time. Never present multiple unrelated questions at once.
  • Auto-detect before asking. Detect the MCP client from the project before asking the user which one they use.
  • Never ask for credentials. The server needs no account and no token. Never prompt for one and never write an Authorization header into the configuration.
  • Pass the matching documentation version. Read @capacitor/core from package.json and pass the matching version on every call. See Documentation Versions.

Procedures

Step 1: Detect the MCP Client

Detect the client instead of asking, by checking the project root in this order:

  1. .mcp.json or .claude/ → Claude Code
  2. .cursor/mcp.json or .cursor/ → Cursor
  3. .vscode/mcp.json or .vscode/ → VS Code

If none of these exist, or if more than one matches, ask the user which client to configure. Claude Desktop, Windsurf, and Zed keep their configuration outside the project, so they cannot be detected this way.

Step 2: Add the Server

Read references/client-setup.md and apply the section for the detected client. Register the server under the name capacitor.

Step 3: Restart the Client and Verify

  1. Tell the user to restart their MCP client so it picks up the new server.
  2. Verify the server by asking the client to run search_docs with a query such as live reload.
  3. If the call fails, go to Error Handling.

Step 4: Use the Server

Once connected, prefer these tools over model knowledge and over reference files bundled with other skills whenever the topic is Capacitor itself — the CLI, the capacitor.config file, the native Android and iOS projects, an official plugin API, or upgrading to a newer major version.

ToolParametersUse for
search_docsquery (required), section, version, limitFinding the page that covers a topic. Start here.
get_doc_pageurl (required), versionReading a full page as Markdown, using a URL from search_docs.
list_pluginsquery, source, limitFinding a plugin for a native capability.
list_blog_posts—Recent Capacitor posts from the Ionic blog, for announcements and release notes.

Apply these rules:

  • Read the whole page before writing code. Search snippets are deliberately short and regularly omit required configuration steps.
  • Narrow with section when the question belongs to one part of the documentation: getting-started, basics, guides, android, ios, web, plugins, apis, cli, reference, updating, or cordova.
  • Pass source to list_plugins as official, community, or all (the default). Results are ranked official plugins first, then plugins maintained by Capawesome, then the remaining community plugins. The server discloses that ranking in its response, so weigh the order instead of treating it as neutral relevance.
  • Route other topics elsewhere. Capawesome plugins and Capawesome Cloud belong to the Capawesome MCP server; Ionic Framework UI components belong to the Ionic Framework MCP server. See Related Skills.

Documentation Versions

The documentation is available for v8 (the default), v7, v6, and next (the unreleased version).

Read the @capacitor/core version from package.json and map it:

@capacitor/coreversion
8.xv8
7.xv7
6.xv6
A pre-release of the next majornext

Pass it on every search_docs and get_doc_page call. Without it the server answers for v8, which documents APIs and CLI flags an older release does not have. list_plugins and list_blog_posts take no version.

Error Handling

  • Server not listed after setup: The cl
阅读完整来源 ↗