用途:引导 AI 智能体逐步把 MCP 客户端接入托管的 Capacitor MCP 服务器,获取当前 Capacitor 文档、官方与社区插件列表,以及 Ionic 博客中的 Capacitor 文章。服务器地址为 https://capacitor-mcp.capawesome.io/mcp,由 Capawesome 维护,属非官方服务,与 Ionic 或 OutSystems 无隶属或背书关系;其内容为官方 Capacitor 文档(Ionic 团队版权所有,Apache-2.0 许可)。
前提:具备支持 Model Context Protocol 的客户端(如 Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Zed 等),能访问上述网址;若客户端只支持启动本地命令,则需 Node.js 22 或更高版本。
主要能力(工具):search_docs(query 必填,section、version、limit)用于先定位主题页面;get_doc_page(url 必填,version)以 Markdown 读取整页;list_plugins(query、source、limit)查找原生能力插件;list_blog_posts 获取近期博客文章。
使用方式:先按项目根目录特征自动识别客户端(.mcp.json 或 .claude/ 对应 Claude Code;.cursor/mcp.json 或 .cursor/ 对应 Cursor;.vscode/mcp.json 或 .vscode/ 对应 VS Code),无法判断时再询问用户。随后按 references/client-setup.md 对应章节注册名为 capacitor 的服务器,重启客户端使其生效,并用 search_docs 执行如 live reload 的查询验证。版本方面,从 package.json 读取 @capacitor/core,8.x 映射 v8、7.x 映射 v7、6.x 映射 v6、下一主版本预发布映射 next,并在每次 search_docs 与 get_doc_page 调用中传入;缺省为 v8。插件来源可传 official、community 或 all(默认),结果按官方、Capawesome 维护、其他社区的顺序排列。
限制与错误处理:不要索取账号或令牌,不写入 Authorization 头;服务器不需要凭据。端点限每 IP 每分钟 100 次请求,超限返回 429,需稍后重试;索引按整词匹配,猜测性词组可能无结果,可减少关键词或用准确包名;索引每日重建,提示构建中时稍后重试。若客户端只能启动本地命令,需使用 @capawesome/capacitor-mcp 的 stdio 代理,且要求 Node.js 22 以上。涉及 Capawesome 插件与 Cloud、Ionic Framework 组件或其他主题时应改用相应服务器。本资料未提供价格与收费信息。