This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
在 Expo 中使用模型上下文协议(MCP)
关于将模型上下文协议与 Expo 项目集成以增强 AI 模型能力的指南。
模型上下文协议(MCP)是一种标准协议,允许 AI 模型与外部数据源集成,为更精确的回应提供增强的上下文。它使像代理这样的 AI 辅助工具能够更深入地理解你的开发环境,从而在你的代码库上提供更好的帮助。
🌐 Model Context Protocol (MCP) is a standard protocol that allows AI models to integrate with external data sources, providing enhanced context for more precise responses. It enables AI-assisted tools like agents to understand your development environment more deeply, allowing them to provide better assistance with your codebase.
Expo MCP 服务器是由 Expo 托管的远程 MCP 服务器,它可以与流行的 AI 辅助工具例如 Claude、Claude Code、Cursor、VS Code 等集成,使它们能够直接与你的 Expo 项目互动。Expo MCP 也可以在 Claude Connectors 中使用,所以你可以通过网页、桌面和移动端的 Claude 连接使用,无需本地安装。
🌐 Expo MCP Server is a remote MCP server hosted by Expo that integrates with popular AI-assisted tools such as Claude, Claude Code, Cursor, VS Code, and others, enabling them to interact directly with your Expo projects. Expo MCP is also available in Claude Connectors, so you can connect from Claude on the web, desktop, and mobile apps with no local installation.

使用 Expo 提升你的 AI 辅助应用构建工具。

看看一个 AI 代理在使用 MCP 服务器的同时用 Expo 构建移动应用。
Expo MCP 服务器是做什么的?
🌐 What does Expo MCP Server do?
Expo MCP 服务器教会你的 AI 辅助工具关于 Expo SDK 的知识,并让它们与移动模拟器和 React Native 开发工具进行互动。以下是一些 Expo MCP 服务器增强的任务示例:
🌐 Expo MCP Server teaches your AI-assisted tools about the Expo SDK and lets them interact with mobile simulators and the React Native DevTools. These are some examples of the tasks Expo MCP Server enhances:
了解使用 Expo 开发。 你的 AI 辅助工具可以按需获取最新的官方 Expo 文档,并用它来回复如下提示信息:
- 我该如何使用 Expo Router?
- 在 Expo 文档中查找实现深度链接的方法
- 阅读 Expo Router 文档页面
- Expo CNG是什么?
管理依赖。 Expo MCP 服务器会引导你安装我们推荐的软件包,并使用 npx expo install 安装已知的兼容版本。
- 添加带有基本 CRUD 操作的 SQLite
- 安装
expo-camera并教我如何拍照 - 添加
expo-notifications以启用推送通知
管理构建和工作流。 Expo MCP 服务器可以触发和监控 EAS 构建,运行工作流,并从 TestFlight 获取崩溃数据:
- 调查为什么我最近在 EAS 上的 iOS 构建失败
- 识别最近失败工作流中的任何模式
- 创建一个运行 Maestro 测试的工作流程
- 显示我最近的 TestFlight 崩溃
- 显示我的应用的 TestFlight 反馈
自动化视觉验证和测试。 多模态 AI 辅助工具可以在模拟器中截图并与正在运行的应用互动。Expo MCP 服务器通过在项目依赖中添加 expo-mcp 包来启用本地功能。
- 添加一个蓝色圆形视图,并确保它正确渲染
- 添加一个按钮,然后点击它以验证交互是否正常
- 添加一个点击会增加计数的按钮,并验证状态是否正确更新
你的 AI 辅助工具可以自主编写代码,捕捉截图以验证界面是否正确,测试交互,并修复发现的问题。
🌐 Your AI-assisted tools can autonomously write the code, capture screenshots to verify the UI is correct, test interactions, and fix issues they find.
MCP 功能 的完整表格记录了 Expo MCP 服务器为 AI 辅助工具提供的工具和提示。
🌐 The complete table of MCP capabilities documents the tools and prompts Expo MCP Server provides to AI-assisted tools.
3 要求
3 要求
1.
使用 Expo MCP 服务器需要一个 Expo 账户。
2.
使用 npx create-expo-app@latest 创建一个项目,或者确保你的现有项目已经安装了最新的 expo 包。
3.
Claude、Claude Code、Cursor、VS Code,或者任何支持远程 MCP 服务器的工具。
安装与设置
🌐 Installation and setup
1
安装 Expo MCP 服务器
🌐 Install Expo MCP Server
Expo MCP 服务器支持与各种 AI 辅助工具集成。使用下面的一般设置,或展开特定工具以获取详细说明:
🌐 Expo MCP Server supports integration with various AI-assisted tools. Use the general settings below or expand your specific tool for detailed instructions:
- 服务器类型:可串流 HTTP
- URL:
https://mcp.expo.dev/mcp - 身份验证:OAuth
Claude 在网页、桌面和移动应用上
Expo MCP 可在 Claude Connectors 中使用。这个设置无需在你的电脑上安装任何东西。点击下面的按钮并按照提示将 Expo 连接器添加到你的 Claude 账户:
🌐 Expo MCP is available in Claude Connectors. This setup requires no installation on your machine. Click the following button and follow the prompts to add the Expo connector to your Claude account:
向Claude添加Expo连接器在 Claude 团队或企业计划中,可以为整个组织启用 Expo 连接器。该组织的成员随后可以在任何设备上使用它,包括手机,而且无需手动安装。
🌐 On a Claude Team or Enterprise plan, the Expo connector can be enabled for the entire organization. Members of that organization can then use it on any device, including their phone, without a manual install.
克劳德代码
如果你已经安装了 expo 插件,它已经注册了这个服务器。跳过下面的命令,在你的会话中运行 /mcp 进行认证。
🌐 If you installed the expo plugin, it already registers this server. Skip the command below and run /mcp in your session to authenticate.
安装后,在你的 Claude Code 会话中运行 /mcp 以进行身份验证。
🌐 After installation, run /mcp in your Claude Code session to authenticate.
- 打开命令面板(Cmd ⌘ + Shift + P 或 Ctrl + Shift + P)
- 运行 MCP:添加服务器
- 选择 HTTP
- 请输入服务器详细信息:
- URL:
https://mcp.expo.dev/mcp - 名称:expo
- URL:
如果你已经安装了expo 插件,它已经注册了这个服务器。跳过下面的命令,直接运行 codex mcp login expo 来进行认证。
🌐 If you installed the expo plugin, it already registers this server. Skip the command below and run codex mcp login expo to authenticate.
上述命令会将 MCP 服务器添加到你的 Codex 配置文件中,并提示你使用 Expo 账户进行身份验证。
🌐 The above command adds the MCP server to your Codex configuration file and prompts you to authenticate with your Expo account.
2
3
设置本地功能(推荐)
🌐 Set up local capabilities (Recommended)
信息 本地功能仅在 SDK 54 及更高版本 中可用。
要获得完整的 MCP 体验,包括从 iOS 模拟器截图、打开开发者工具和自动化功能,请设置本地 Expo 开发服务器:
🌐 For the full MCP experience with advanced features like taking screenshots from your iOS Simulator, opening DevTools, and automation capabilities, set up a local Expo development server:
重要 每当你启动或停止开发服务器时,你需要在 AI 辅助工具中 重新连接或重启 你的 MCP 服务器连接,以确保 AI 辅助工具获得更新的功能。
服务器能力与本地能力
🌐 Server capabilities versus local capabilities
Expo MCP 服务器根据你的设置提供两种类型的功能:
🌐 Expo MCP Server provides two types of capabilities depending on your setup:
服务器功能
🌐 Server capabilities
服务器功能仅通过远程 MCP 服务器连接即可使用,无需搭建本地开发服务器。
🌐 Server capabilities are available with just the remote MCP server connection, without needing to set up a local development server.
本地能力
🌐 Local capabilities
本地功能需要本地 Expo 开发服务器运行,并提供与本地开发环境交互的高级功能:
🌐 Local capabilities require a local Expo development server to be running and provide advanced features that interact with your local development environment:
- 自动化工具:截屏、点击视图、通过 testID 查找元素
- 开发工具:打开 React Native 开发工具
- 项目分析:生成
expo-router网站地图
这些功能使更复杂的工作流程成为可能,例如自动化测试、视觉验证和更深入的项目分析。要使用本地功能,你需要遵循上文的设置本地功能部分。
🌐 These capabilities enable more sophisticated workflows like automated testing, visual verification, and deeper project introspection. To use local capabilities, you will need to follow the Set up local capabilities section above.
可用的MCP功能
🌐 Available MCP capabilities
信息 MCP 的功能可能会随着
expo-mcp套件更新或 MCP 服务器的更改而变化。以下列表仅供参考,可能不是最新的。
工具
🌐 Tools
提示
🌐 Prompts
如果你的 AI 辅助工具支持 MCP 提示,你可能会看到额外的菜单选项,例如 Claude Code 中的斜杠命令:
🌐 If your AI-assisted tool supports MCP prompts, you may see additional menu options, such as slash commands in Claude Code:
局限性
🌐 Limitations
当前的实现存在以下限制:
🌐 The current implementation has the following limitations:
- 一次仅支持连接 单个开发服务器
- iOS 对本地功能的支持仅限于模拟器(尚不支持物理设备)
- iOS 对本地功能的支持仅在 macOS 主机上可用。
数据隐私
🌐 Data privacy
Expo 不会使用发送到 Expo MCP 服务器的数据来训练 AI 模型。Expo MCP 服务器本身也不会运行 AI 模型。它提供 MCP 工具和提示给你连接的 AI 辅助工具,比如 Claude、Claude Code、Cursor 或 VS Code。
🌐 Expo does not use data sent to Expo MCP Server to train AI models. Expo MCP Server does not run an AI model itself. It provides MCP tools and prompts to the AI-assisted tool you connect, such as Claude, Claude Code, Cursor, or VS Code.
对于服务器功能,Expo MCP 服务器可能会访问完成所请求工具调用所需的 Expo 账户和项目数据,例如构建、工作流、文档或与 TestFlight 相关的数据。结果将通过 MCP 连接返回给你的 AI 辅助工具。
🌐 For server capabilities, Expo MCP Server may access Expo account and project data needed to complete the requested tool call, such as build, workflow, documentation, or TestFlight-related data. The result is returned to your AI-assisted tool over the MCP connection.
对于本地功能,来自你的开发机器的数据会通过 Expo MCP 服务器代理,并返回到你的 AI 辅助工具。例如,当 AI 辅助工具请求拍摄模拟器屏幕截图时,数据流如下:
🌐 For local capabilities, data from your development machine is proxied through Expo MCP Server and returned to your AI-assisted tool. For example, when an AI-assisted tool asks to take a simulator screenshot, the data flow is:
- 本地 Expo 开发服务器会从你的模拟器捕获屏幕截图。
- 屏幕截图已发送到 Expo MCP 服务器。
- Expo MCP 服务器将屏幕截图返回到你的本地 MCP 客户端或 AI 辅助工具。
Expo MCP 服务器会将数据返回给你连接的 MCP 客户端,例如 Claude、Claude Code、Cursor、VS Code 或 Codex。之后,客户端及其模型提供方可能会应用他们自己的数据保留、零数据保留(ZDR)和训练政策。在为处理敏感数据的项目启用 MCP 访问之前,请先查看这些政策,包括 HIPAA、SOC 2 或其他受监管的工作负载。
🌐 Expo MCP Server returns data to the MCP client you connect, such as Claude, Claude Code, Cursor, VS Code, or Codex. From there, the client and its model provider may apply their own retention, zero data retention (ZDR), and training policies. Review those policies before enabling MCP access for projects that handle sensitive data, including HIPAA, SOC 2, or other regulated workloads.
其他资源
🌐 Additional resources
了解有关 MCP 规范和协议详情的更多信息。