local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides tools for managing Expo development servers for React Native applications, including starting, stopping, and monitoring servers, capturing logs, and retrieving log statistics.
Offers file system operations within project directories, allowing reading, writing, and listing files to support development and debugging workflows.
Enables starting Expo development servers specifically for iOS application development and testing.
Expo MCP Server
A Model Context Protocol (MCP) server that provides development and debugging tools for Expo-based React Native applications. This project integrates logging, process management, and file tooling to streamline automation and AI-based workflows.
Features
- Start, stop, and monitor Expo development servers
- Capture and filter
stdout/stderrlogs - Read, write, and list files in the project directory
- Query log statistics and clear logs
- Extendable via custom MCP tools
- Includes a packed single-file representation for AI processing (via Repomix)
Usage
CLI
Development
Testing
Available Tools
| Tool Name | Description |
|---|---|
expoStart | Start Expo dev server (iOS by default) |
expoStop | Stop running Expo dev server |
expoStatus | Show status and logs for Expo server |
expoLogs | Retrieve recent Expo logs |
expoGetLogs | Filtered logs with advanced options |
expoLogStats | Summary statistics of current logs |
expoClearLogs | Clear all stored logs |
readFile | Read contents of a file |
writeFile | Write content to a file |
listFiles | List files in a directory |
listTools | List all tools registered in the server |
Installation
Build
Known Issues / To-Do
- MCP server shutdown does not always kill the child Expo process
- Relies on global state to track process existence; should verify by PID instead
- Logs are not helpful when the server fails to start; improve error diagnostics
- Clients misunderstand
expoLogsusage, leading to incorrect assumptions and unnecessary restarts - Should query logs from persisted log files instead of in-memory child process events for robustness
npm run startis... unkillable?
License
MIT
You must be authenticated.
A Model Context Protocol server that provides development and debugging tools for Expo-based React Native applications, enabling developers to manage Expo servers, capture logs, and manipulate project files.