极客离子MCP服务器

Name: 极客离子MCP服务器
Author: Tommertom

作者：Tommertom25 星标更新：2025-11-15

安装使用来源：spider==github.com

项目介绍

Awesome Ionic MCP 服务器

由模型上下文协议（MCP）驱动的全面 Ionic 编码伴侣。这款智能服务器提供了对 Ionic 框架组件、Capacitor 插件、开发者资源以及 CLI 命令执行 的无缝访问，以加速您的移动应用开发工作流程。无论您是使用 React、Angular、Vue 或 Vanilla JavaScript 构建跨平台应用程序，此 MCP 服务器都能提供实时组件定义、API 文档、代码示例、插件信息，并能够直接通过您的 AI 助手执行 Ionic/Capacitor CLI 命令，从而实现更快的开发和更好的代码质量。

数据来源于 @ionic/core 包、ionicframework.com、docs-demo.ionic.io、capacitorjs.com、capawesome.io、capacitor-community 和 capgo.live，以确保准确性和完整性。

可用工具

工具名称	特征组	描述
get_ionic_component_definition	@ionic/core.json	根据其 HTML 标签检索 Ionic 组件的 TypeScript 定义。
get_all_ionic_components	@ionic/core.json	检索此工具可用的所有 Ionic 组件列表。
get_component_api	ionicframework.com	使用其 HTML 标签从 IonicFramework 页面检索组件 API。
get_component_demo	docs-demo.ionic.io	根据其 HTML 标签从 GitHub 存储库返回组件演示。
get_official_plugin_api	capacitorjs.com	使用其 HTML 标签从 Capacitor 页面检索官方插件 API。
get_all_official_plugins	capacitorjs.com	检索所有官方 Capacitor 插件列表。
get_all_plugins	capawesome.io	检索所有 Capawesome Capacitor 插件列表（免费版和内部版）。
get_all_free_plugins	capawesome.io	检索所有 Capawesome Capacitor 免费插件列表 - 经过精心策划并保持最新。
get_all_insider_plugins	capawesome.io	检索所有 Capawesome Capacitor 内部插件列表 - 经过精心策划并保持最新。
get_plugin_api	capawesome.io	检索特定 Capawesome Capacitor 插件的 API 文档。
get_capacitor_community_plugin_api	capacitor-community	检索特定 Capacitor 社区插件的 API 文档。
get_all_capacitor_community_plugins	capacitor-community	检索所有 Capacitor 社区插件列表。
get_capgo_plugin_api	capgo	检索特定 CapGo 插件的 API 文档。
get_all_capgo_plugins	capgo	检索所有 CapGo 插件列表。
get_all_capacitor_plugins	all-capacitor-plugins	超级列表，包含来自不同发布者的所有 Capacitor 插件，您可以使用此 MCP 工具检索 API 信息。如果您不确定使用哪个插件，此工具将帮助您找到合适的插件。
ionic_info	ionic-cli	获取项目、系统和环境的综合信息
ionic_config_get	ionic-cli	读取 CLI 或项目配置值
ionic_config_set	ionic-cli	设置 CLI 或项目配置值
ionic_config_unset	ionic-cli	删除/取消设置配置值
ionic_start	ionic-cli	创建一个新的 Ionic 项目
ionic_start_list	ionic-cli	列出可用的 Ionic 启动模板
ionic_init	ionic-cli	使用 Ionic 初始化现有项目
ionic_build	ionic-cli	构建用于部署的 Web 资产
ionic_serve	ionic-cli	启动本地开发服务器
ionic_generate	ionic-cli	生成页面、组件和服务
ionic_repair	ionic-cli	修复项目依赖项
integrations_list	ionic-cli	列出项目集成
integrations_enable	ionic-cli	在项目中启用集成
integrations_disable	ionic-cli	在项目中禁用集成
capacitor_doctor	ionic-cli	检查 Capacitor 设置中的错误
capacitor_list_plugins	ionic-cli	列出已安装的 Capacitor 插件
capacitor_sync	ionic-cli	同步 Web 资产和依赖项
capacitor_copy	ionic-cli	将 Web 资产复制到本机平台
capacitor_update	ionic-cli	更新本机依赖项
capacitor_init	ionic-cli	初始化 Capacitor 配置
capacitor_add	ionic-cli	添加本机平台（iOS/Android）
capacitor_build	ionic-cli	构建本机平台发布版
capacitor_run	ionic-cli	在设备或模拟器上运行应用
capacitor_open	ionic-cli	打开本机 IDE
capacitor_migrate	ionic-cli	迁移到最新版本的 Capacitor

CLI 工具

Awesome Ionic MCP 服务器现在包括 28 个 Ionic 和 Capacitor CLI 工具，允许您通过 AI 助手直接执行命令：

项目信息与诊断

ionic_info - 获取项目、系统和环境信息
capacitor_doctor - 检查设置中的配置错误
capacitor_list_plugins - 列出所有已安装的插件
ionic_config_get/set/unset - 管理配置值
integrations_list - 列出可用的集成

开发工作流

ionic_build - 构建带有优化的 Web 资产
ionic_serve - 启动开发服务器（建议手动启动）
capacitor_sync - 同步 Web 资产并更新本机依赖项
capacitor_copy - 将 Web 资产复制到本机平台
capacitor_update - 更新本机插件

代码生成

ionic_generate - 生成页面、组件、服务、守卫、管道
框架特定的脚手架，适用于 Angular、React、Vue

项目设置与管理

ionic_start - 创建新的 Ionic 项目
ionic_start_list - 列出可用的模板
ionic_init - 使用 Ionic 初始化现有项目
capacitor_init - 初始化 Capacitor 配置
capacitor_add - 添加 iOS 或 Android 平台
integrations_enable/disable - 管理项目集成

本机开发

capacitor_build - 构建本机应用发布版
capacitor_run - 在设备或模拟器上运行
capacitor_open - 打开 Xcode 或 Android Studio
capacitor_migrate - 迁移到最新版本的 Capacitor

维护

ionic_repair - 修复依赖项并重新生成文件

常见工作流

创建新项目：

// 1. 创建项目
ionic_start({ name: "MyApp", template: "tabs", type: "react", capacitor: true })

// 2. 添加 iOS 平台
capacitor_add({ project_directory: "./MyApp", platform: "ios" })

// 3. 构建和同步
ionic_build({ project_directory: "./MyApp", prod: true })
capacitor_sync({ project_directory: "./MyApp", platform: "ios" })

检查项目健康状况：

ionic_info({ format: "json" })
capacitor_doctor({ platform: "ios" })
capacitor_list_plugins({})

生成组件：

ionic_generate({ type: "page", name: "home" })
ionic_generate({ type: "component", name: "user-card" })
ionic_generate({ type: "service", name: "auth" })

开始使用及注意事项

Awesome Ionic MCP 服务器可以与支持标准 I/O（stdio）作为传输介质的任何 MCP 客户端一起工作。以下是某些流行工具的具体说明：

请注意 - 对于某些数据，MCP 服务器将运行 Puppeteer 来打开浏览器并获取数据。因此，您会看到一个浏览器窗口被打开和关闭。

基本配置

Claude Desktop

要配置 Claude Desktop 使用 Awesome Ionic MCP 服务器，请编辑 claude_desktop_config.json 文件。您可以通过 Claude > 设置菜单打开或创建此文件。选择“开发者”标签，然后点击“编辑配置”。

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

Cline

要配置 Cline 使用 Awesome Ionic MCP 服务器，请编辑 cline_mcp_settings.json 文件。您可以通过点击 Cline 面板顶部的 MCP 服务器图标，然后点击“配置 MCP 服务器”按钮来打开或创建此文件。

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"],
      "disabled": false
    }
  }
}

Cursor

要配置 Cursor 使用 Awesome Ionic MCP 服务器，请编辑 .cursor/mcp.json 文件（仅配置特定项目）或 ~/.cursor/mcp.json 文件（使 MCP 服务器在所有项目中可用）。

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

环境变量

服务器支持可选环境变量以增强功能：

`GITHUB_TOKEN`（推荐）

目的： 认证 GitHub API 请求以避免速率限制

为什么需要： 服务器从 GitHub 组织（CapGo、Capacitor 社区）获取插件数据。没有认证的情况下，GitHub 每小时每个 IP 地址限制您 60 次 API 请求。服务器在初始化期间进行约 160+ 次 API 调用，这会在单次启动时耗尽未认证的限制。使用令牌后，限制增加到每小时 5,000 次请求。

如何获取令牌：

前往 GitHub 设置 → 开发者设置 → 个人访问令牌 → 令牌（经典）
点击“生成新令牌（经典）”
给它一个描述性名称（例如，“Awesome Ionic MCP”）
公共存储库访问不需要特殊范围/权限
复制生成的令牌（以 ghp_ 开头）

配置示例：

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

`MCP_QUIET`

目的： 抑制信息日志（仅显示错误） 何时使用： 如果您希望最小的日志输出