capacitor-mcp

Capacitor MCP 服务

面向官方 Capacitor 文档的非官方 MCP 服务。它为 AI 助手提供 Capacitor v8、v7、v6 和 next 的最新文档、官方和社区插件列表，以及 Ionic 博客中关于 Capacitor 的文章，从而避免它们猜测插件 API 和 CLI 标志。本项目与 Ionic 或 OutSystems 无关，也未获得其认可。

由 Capawesome 维护。

端点

该服务已托管并可随时使用。无需账号、令牌或安装：

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

安装

Claude Code

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

Claude Desktop / Claude.ai

前往 Settings → Connectors → Add custom connector 并填写：

• 名称：Capacitor
• URL：https://capacitor-mcp.capawesome.io/mcp

Cursor

或者在项目中添加 .cursor/mcp.json：

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

VS Code

在 VS Code 中安装

或者在项目中添加 .vscode/mcp.json：

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

Windsurf

将该服务添加到 ~/.codeium/windsurf/mcp_config.json：

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

Zed

将该服务添加到 Zed 的 settings.json：

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

通过 npx 连接任何客户端

无法通过 HTTP 连接远程服务的客户端，可以运行此包，通过代理将 stdio 转发到托管服务：

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

需要 Node.js 22 或更高版本。

工具

工具	用途	参数
search_docs	按关键词搜索文档。任何 Capacitor 相关问题都可从这里开始。	query（必需）、section、version、limit
get_doc_page	阅读 search_docs 返回的完整文档页面。	url（必需）、version
list_plugins	列出官方和社区 Capacitor 插件。	query、source、limit
list_blog_posts	列出 Ionic 博客中近期发布的 Capacitor 相关文章。	—

版本

文档提供 Capacitor v8（默认）、v7、v6 和 next 版本。向 search_docs 和 get_doc_page 传递 version 参数，即可指定目标版本。

速率限制

该端点的限制为每个 IP 每分钟 100 个请求。超过限制的请求将收到 429 Too Many Requests；请稍等片刻后重试。

隐私

你的 IP 地址仅用于速率限制。查询和工具参数不会被存储，也不会记录在 Cloudflare 的标准边缘日志之外，更不会用于训练。详情请参阅隐私政策。

相关项目

• Ionic Framework MCP Server — 用于 Ionic Framework 文档、组件和用法示例的同类服务。
• Capawesome MCP Server — 用于 Capawesome 文档和 Capawesome Cloud 管理 API 的官方 MCP 服务。
• Capawesome Cloud Live Updates — 无需经过应用商店审核，即可将 JavaScript、HTML 和 CSS 更改发布到应用中。
• Capawesome Cloud Native Builds — 在云端构建原生 iOS 和 Android 应用，无需 Mac。
• Capawesome Cloud App Store Publishing — 将构建版本提交到 Apple App Store 和 Google Play Store。

归属说明

文档内容 © Ionic 团队，采用 Apache-2.0 许可，来源于 ionic-team/capacitor-docs。这些内容从 MDX 转换为 Markdown，以便通过 MCP 提供；除此之外，实质内容未经修改。社区插件列表来自 capawesome-team/awesome-capacitorjs。博客摘录来自 Ionic blog，并链接到原文。

完整归属信息请参见 NOTICE。

开发

npm install
npm run build
npm test

将 CAPACITOR_MCP_URL 设置为指向本地服务，而非托管服务：

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

发布

发布由 release-please 管理。合并其发布拉取请求后，会为版本添加标签、将软件包发布到 npm，随后将 server.json 发布到 MCP Registry。server.json 中的版本会由 release-please 与 package.json 一起递增，因此无需手动编辑。如需手动发布到注册表，请安装 mcp-publisher，使用密码管理器中的 Ed25519 私钥运行 mcp-publisher login dns --domain=capawesome.io --private-key=<key>，然后运行 mcp-publisher publish。

许可证

请参见 LICENSE。