用途
Awesome Ionic MCP 服务器是 Ionic 框架的编程伴侣，基于 Model Context Protocol (MCP)，为使用 React、Angular、Vue 或原生 JavaScript 构建移动应用的开发者提供智能辅助。它无缝整合 Ionic 组件、Capacitor 插件、开发者资源及 CLI 命令执行，以加速跨平台移动应用开发工作流。
主要能力
该服务器提供 28 个 Ionic 和 Capacitor CLI 工具，可通过 AI 助手执行命令：
- 项目信息与诊断：ionic_info、capacitor_doctor、capacitor_list_plugins、ionic_config_get/set/unset、integrations_list。
- 开发工作流：ionic_build、ionic_serve（建议手动启动）、capacitor_sync、capacitor_copy、capacitor_update。
- 代码生成：ionic_generate（支持 Angular、React、Vue 框架的页面、组件、服务、守卫、管道脚手架）。
- 项目设置与管理：ionic_start、ionic_start_list、ionic_init、capacitor_init、capacitor_add、integrations_enable/disable。
- 原生开发：capacitor_build、capacitor_run、capacitor_open、capacitor_migrate、ionic_repair。 它还能向 AI 助手提供实时的组件定义、API 文档、代码示例和插件信息，帮助提升代码质量。
使用方式
服务器可与任何支持标准输入输出（stdio）作为传输媒介的 MCP 客户端配合使用。常见配置包括：
- Claude Desktop：编辑 claude_desktop_config.json 文件（通过 Claude > Settings > Developer 标签 > Edit Config）。
- Cline：编辑 cline_mcp_settings.json 文件（点击 Cline 面板顶部的 MCP Servers 图标，然后点击 Configure MCP Servers）。
- Cursor：编辑 .cursor/mcp.json（仅特定项目）或 ~/.cursor/mcp.json（所有项目）。
- VS Code：在工作区编辑 .vscode/mcp.json（单项目），或编辑用户设置（所有项目）。
- Windsurf Editor：编辑 ~/.codeium/windsurf/mcp_config.json 文件。
可选环境变量：
- GITHUB_TOKEN（推荐）：用于认证 GitHub API 请求，避免速率限制。服务器从 GitHub 组织（CapGo、Capacitor Community）获取插件数据，初始化时约进行 160+ 次 API 调用，未认证时每小时每 IP 仅限 60 次请求，使用令牌后可提升至每小时 5,000 次。获取令牌：GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)，生成新令牌（无需特殊权限，仅公共仓库访问），复制以 ghp_ 开头的令牌。
- 另一个环境变量用于抑制信息日志，仅显示错误。
注意：部分数据获取会运行 Puppeteer 打开浏览器窗口然后关闭。
适用场景
适用于使用 Ionic 和 Capacitor 进行跨平台移动应用开发的场景，特别是希望借助 AI 助手快速访问组件文档、生成代码、执行 CLI 命令的开发者。无论使用 React、Angular、Vue 还是原生 JavaScript，均可受益。
限制
暂未提供其他限制信息。
