Capacitor Mcp

io.capawesome由 capawesome.io 發布官方發布者v0.0.1更新於 Oct 24, 2026

Unofficial MCP server for the Capacitor documentation, plugin list and blog.

已驗證Streamable HTTP可網頁執行知識與記憶開發者工具

概覽

AI 產生的概覽

非官方 MCP 伺服器,為助理提供 Capacitor 官方文件、外掛清單與 Ionic 部落格文章,避免猜測 API 與 CLI 參數。

可以做什麼
  • 依關鍵字搜尋 Capacitor 官方文件,可依章節與版本限縮範圍
  • 在搜尋後讀取單一文件頁面的完整 Markdown 內容
  • 列出官方與社群 Capacitor 外掛及其套件名稱與維護者
  • 列出 Ionic 部落格中最近 10 篇 Capacitor 相關文章
適用情境
適合在開發或維護 Capacitor 應用程式時使用,讓助理依據目前的 v8、v7、v6 或 next 文件回答,而不是猜測外掛 API、CLI 指令或原生設定。也適合為某項原生能力尋找外掛,以及了解近期的版本發布與棄用資訊。
執行需求
使用託管端點無需任何條件:不需要帳號、權杖或安裝。無法連線遠端 HTTP 的用戶端可透過 npx 執行 npm 套件 @capawesome/capacitor-mcp,需要 Node.js 22 或更新版本,並將 stdio 代理至託管伺服器。
安裝前請注意
僅供唯讀文件查詢,不索取任何憑證。端點限制為每個 IP 每分鐘 100 次請求,超出會回傳 429。IP 位址僅用於流量限制,查詢會經過 Cloudflare 邊緣日誌。此伺服器為非官方專案,與 Ionic 或 OutSystems 無關聯。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Capacitor Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.capawesome%2Fcapacitor-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "capacitor": {
      "type": "http",
      "url": "https://capacitor-mcp.capawesome.io/mcp"
    }
  }
}

README

Capacitor MCP Server

Unofficial MCP server for the official Capacitor documentation. It gives AI assistants the current documentation for Capacitor v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog — so they stop guessing plugin APIs and CLI flags. Not affiliated with or endorsed by Ionic or OutSystems.

Maintained by Capawesome.

Endpoint

The server is hosted and ready to use. No account, no token, no installation:

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

Installation

Claude Code

bash
claude mcp add --transport http capacitor https://capacitor-mcp.capawesome.io/mcp

Claude Desktop / Claude.ai

Go to Settings → Connectors → Add custom connector and enter:

  • Name: Capacitor
  • URL: https://capacitor-mcp.capawesome.io/mcp

Cursor

[Install in Cursor]

Or add .cursor/mcp.json to your project:

json
{  "mcpServers": {    "capacitor": {      "url": "https://capacitor-mcp.capawesome.io/mcp"    }  }}

VS Code

Install in VS Code

Or add .vscode/mcp.json to your project:

json
{  "servers": {    "capacitor": {      "type": "http",      "url": "https://capacitor-mcp.capawesome.io/mcp"    }  }}

Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "capacitor": {      "serverUrl": "https://capacitor-mcp.capawesome.io/mcp"    }  }}

Zed

Add the server to your Zed settings.json:

json
{  "context_servers": {    "capacitor": {      "url": "https://capacitor-mcp.capawesome.io/mcp"    }  }}

Any client via npx

Clients that cannot connect to a remote server over HTTP can run this package, which proxies stdio to the hosted server:

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

Requires Node.js 22 or later.

Tools

ToolPurposeParameters
search_docsSearch the documentation by keyword. Start here for any Capacitor question.query (required), section, version, limit
get_doc_pageRead a full documentation page returned by search_docs.url (required), version
list_pluginsList official and community Capacitor plugins.query, source, limit
list_blog_postsList recent Capacitor posts from the Ionic blog.—

Versions

The documentation is available for Capacitor v8 (default), v7, v6 and next. Pass the version parameter to search_docs and get_doc_page to target a specific version.

Rate limits

The endpoint is limited to 100 requests per minute per IP. Requests over the limit are answered with 429 Too Many Requests; retry after a short wait.

Privacy

Your IP address is processed for rate limiting only. Queries and tool arguments are not stored, not logged beyond Cloudflare's standard edge logs, and never used for training. See the Privacy Policy for details.

Related

Attribution

The documentation content is © the Ionic team, licensed under Apache-2.0 and sourced from ionic-team/capacitor-docs. It is converted from MDX to Markdown for delivery over MCP and otherwise served unmodified in substance. The community plugin list comes from capawesome-team/awesome-capacitorjs. Blog excerpts come from the Ionic blog and link to the original post.

See NOTICE for the full attribution.

Development

bash
npm installnpm run buildnpm test

Set CAPACITOR_MCP_URL to point the proxy at a local server instead of the hosted one:

bash
CAPACITOR_MCP_URL=http://localhost:8787/mcp node dist/index.js

Release

Releases are managed by release-please. Merging its release pull request tags the version, publishes the package to npm and then publishes server.json to the MCP Registry. The version in server.json is bumped by release-please together with package.json, so it never has to be edited by hand. To publish to the registry manually, install mcp-publisher, run mcp-publisher login dns --domain=capawesome.io --private-key=<key> with the Ed25519 private key from the password manager and then mcp-publisher publish.

License

See LICENSE.

來源:README.md,提交 5cb0ab7

工具

4

search_docs

Search Capacitor documentation

Search the official Capacitor documentation from capacitorjs.com by keyword. Use this first for any question about Capacitor itself — the CLI, the `capacitor.config` file, the native Android and iOS projects, the official plugin APIs, or upgrading to a newer major version — because guessing an API, a configuration option or a CLI flag produces broken code. Returns the best matching page sections with `title`, `url`, `snippet`, `section` and `version`, plus the `parentTitle` and `parentUrl` of the page a section belongs to. The same results are attached as structured content. Do not use this to read a whole page (call `get_doc_page` with a `url` from these results), to look up Capawesome plugins such as @capawesome/capacitor-file-picker or Capawesome Cloud services such as Live Updates, Native Builds and App Store Publishing (use the Capawesome MCP server at https://mcp.capawesome.io/mcp instead), or to look up Ionic Framework UI components (use the Ionic Framework MCP server at https://ionic-framework-mcp.capawesome.io/mcp instead).

輸入參數limitquery必填sectionversion

get_doc_page

Read a documentation page

Read the full markdown of a single page of the official Capacitor documentation. Use this after `search_docs` to read a page end to end before writing code against a plugin API, a CLI command or a native configuration, because search snippets are deliberately short and regularly omit required setup steps. Returns the page title, its URL, the documentation version and the complete page markdown including code samples. Do not use this to find a page: it needs an exact URL or path, so run `search_docs` first. Do not use it for pages outside capacitorjs.com — Capawesome plugins and Capawesome Cloud are covered by the Capawesome MCP server at https://mcp.capawesome.io/mcp, Ionic Framework UI components by the Ionic Framework MCP server at https://ionic-framework-mcp.capawesome.io/mcp.

輸入參數url必填version

list_plugins

List Capacitor plugins

List Capacitor plugins: the official plugins maintained by the Capacitor team and community plugins from the awesome-capacitorjs list maintained by Capawesome. Use this to find a plugin for a native capability before writing custom native code, and to learn which package name and maintainer a capability belongs to. Returns `name`, `description`, `source`, `maintainer` and `url` per plugin, plus `core: true` for a plugin that ships with @capacitor/core and `experimental: true` for an experimental one. Results are ranked by relevance, with official Capacitor plugins ranked first, then plugins maintained by Capawesome, then other community plugins. Do not use this to read a plugin's API: call `get_doc_page` with the `url` of an official plugin, and use the Capawesome MCP server at https://mcp.capawesome.io/mcp for Capawesome plugins.

輸入參數limitquerysource

list_blog_posts

List recent blog posts

List the 10 most recent posts from the Capacitor tag of the official Ionic blog, newest first. Use this when the question is about what is new — recent releases, announcements or deprecations. The blog covers both Capacitor and Ionic Framework. Returns `title`, `date`, `tags`, `url` and `excerpt` per post. Do not use this to answer a documentation question: the feed only carries the newest posts, so search the documentation with `search_docs` instead.

無需輸入參數。

版本歷史

1
  1. v0.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Capawesome 整合