gluestack-ui-mcp-server 是一个专为 React Native 优先开发打造的 Model Context Protocol (MCP) 服务器，目标是通过 AI 助手为使用 Gluestack UI 的跨平台应用开发提供全面支持。它让 AI 助手能够访问 Gluestack UI 组件库，覆盖 iOS、Android 与 Web，并提供针对 React Native 工作流优化的组件、源码与示例。
主要用途 该服务器面向使用 Gluestack UI 的 React Native 开发者，帮助 AI 助手在生成界面、组件与导航流程时获得准确的组件上下文，从而加速开发并提升代码质量。
主要能力
- React Native 优先：提供 70+ 个生产就绪的 React Native 组件，支持 iOS、Android 与 Web 单一代码库，兼容 Expo 工作流与 Expo Router、EAS Build，并内置 stack、tab、drawer 等导航模式支持；组件会自动适配 iOS 与 Android 设计规范。
- 多变体架构：支持 NativeWind（基于 Tailwind CSS 与 react-native-css-interop 优化）、Themed（使用 Gluestack 设计令牌系统）以及 Unstyled（无样式 headless 组件，便于最大程度自定义）。
- React Native 优化智能：TypeScript 优先，提供完整的组件属性定义；能识别 Platform.OS 检测与平台特定代码；内置 Expo 真实使用模式和 React Native 性能最佳实践示例。
- 跨平台支持：一次编写，运行于 iOS、Android 与 Web；响应式设计适配不同屏幕尺寸与方向；支持 React Native Web 集成。
- 开发加速：支持 GitHub 模式直接获取仓库最新组件，或使用本地 Gluestack UI 安装进行快速迭代；AI 可辅助生成 React Native 屏幕、组件和导航流程；组件带有无障碍标签与测试 ID。
- 组件发现与导航：列出 126+ 个可用组件及其变体；比较并选择具体组件的 NativeWind、Themed、Unstyled 版本；浏览 gluestack-ui monorepo 目录。
- 代码、示例与元数据：获取任意组件变体的完整未修改源码；从 Storybook 获取经过验证的使用示例；提取 TypeScript 属性、导入依赖和注释文档。
使用方式 前置环境需要 React Native CLI 或 Expo CLI、iOS 模拟器（Mac）和/或 Android 模拟器、Metro 打包器，以及组件来源（本地 Gluestack UI 安装/克隆，或 GitHub Personal Access Token）。安装后可将服务器加入 Claude Desktop 配置文件（~/.config/claude/config.json）或用于命令行。
配置选项 环境变量包括 GLUESTACK_PATH（本地 Gluestack UI 安装路径）、GITHUB_TOKEN（GitHub Personal Access Token）、LOG_LEVEL（debug、info、warn、error）。命令行参数包括 --gluestack-path、--log-level、--help。
GitHub 模式 无需本地安装，可从官方仓库主分支获取最新组件；需要生成具有 public_repo 权限的经典 Personal Access Token，令牌以 ghp_ 开头；认证请求可获得更高 GitHub API 速率限制（5000/小时 vs 60/小时），并始终获取最新组件、无需本地维护。
可用工具 list_components：列出所有 70+ 可用组件；get_component：获取组件源码；get_component_demo：获取组件示例与 stories；get_component_metadata：提取属性、依赖与示例；list_component_variants：显示组件的所有变体。
支持组件示例 布局（Box、Center、HStack、VStack、Grid、Divider）、表单（Input、Textarea、Button、Checkbox、Radio、Select、Slider、Switch）、反馈（Alert、Toast、Progress、Spinner、Skeleton）、覆盖层（Modal、AlertDialog、Popover、Tooltip、ActionSheet）、数据展示（Avatar、Badge、Card、Image、Table）、导航（Tabs、Menu、Link）、媒体（Image、ImageViewer）、工具（Portal、Pressable、SafeAreaView）等 126+ 组件。
适用场景 适合需要 AI 辅助生成 React Native 界面、快速原型搭建、跨平台组件选型与代码生成、使用 Expo 或 React Native CLI 的项目，以及希望减少手动查阅文档、提升开发一致性与无障碍实践的团队。
限制 需具备 React Native 开发环境；本地模式需要安装或克隆 Gluestack UI；GitHub 模式需要 Personal Access Token；部分具体安装命令、价格与收费信息在资料中暂未提供。
