expo-docs
Provides tools for searching and retrieving Expo documentation, including SDK references, quick start guides, and full-text search across documentation sections.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Expo Docs MCP Server
A blazing-fast MCP (Model Context Protocol) server for Expo documentation that reads directly from local .mdx files.
š Key Features
Lightning Fast: Reads directly from local
.mdxfiles - no HTTP server neededSmart Caching: Disk-based cache with version + docs fingerprint invalidation
Full-Text Search: Powerful search with intelligent scoring algorithm
Zero Network: Works completely offline
Optimized for Bun: Built specifically for Bun's performance
Related MCP server: Expo Docs MCP Server
š Performance
Metric | First Run | Cached Run |
Index Build | ~90-120ms | ~12-20ms |
Search Query | ~1-10ms | ~1-10ms |
Documents | 997 .mdx files | 997 .mdx files |
Cache Size | ~4.4MB | ~4.4MB |
Measured on the current local docs snapshot.
š ļø Setup
Choose your preferred installation method:
Option 1: npx (Zero Install)
No installation needed! Just add to your Cursor MCP configuration:
{
"mcpServers": {
"expo-docs": {
"command": "npx",
"args": ["expo-local-docs-mcp"]
}
}
}ā
Always uses latest version
ā
No manual updates needed
ā ļø Slight delay on first run (cached after)
Option 2: Global Install (Recommended)
Install once, use everywhere:
npm install -g expo-local-docs-mcp
# or with pnpm
pnpm install -g expo-local-docs-mcpThen add to your Cursor MCP configuration:
{
"mcpServers": {
"expo-docs": {
"command": "expo-local-docs-mcp"
}
}
}ā
Instant startup (no download)
ā
Cleaner config
ā ļø Manual updates: npm update -g expo-local-docs-mcp
Option 3: Local Project Install
Install in your project:
cd ~/my-expo-project
npm install expo-local-docs-mcpThen add to your Cursor MCP configuration:
{
"mcpServers": {
"expo-docs": {
"command": "node",
"args": [
"/absolute/path/to/node_modules/expo-local-docs-mcp/dist/server.js"
]
}
}
}ā
Version locked to project
ā ļø Must install per project
ā ļø Need absolute path in config
That's it! The package includes 997 Expo SDK docs in the current snapshot and works out of the box with any method.
For Contributors: Local Development
If you want to contribute or customize:
Prerequisites
Bun installed (recommended) or Node.js
Expo documentation
.mdxfiles in theexpo-sdk/folder
Installation
cd /path/to/expo-local-docs-mcp
bun install
bun run buildTest It Works
bun run testYou should see:
ā
All tests passed!
ā Index loaded: 997 entries (~90-120ms first run)
ā Index loaded: 997 entries (~12-20ms cached run)Configuration for Local Development
Add to your Cursor MCP configuration (~/.cursor/mcp.json or ~/.config/cursor/mcp.json):
{
"mcpServers": {
"expo-docs": {
"command": "bun",
"args": ["/<workingdirectory>/expo-local-docs-mcp/dist/server.js"],
"env": {
"EXPO_DOCS_PATH": "/<workingdirectory>/expo-local-docs-mcp/expo-sdk",
"EXPO_CACHE_DIR": "/<workingdirectory>/expo-local-docs-mcp/.expo-cache"
}
}
}
}Important: Update the paths to match your actual installation location.
š Available Tools
1. search_expo_docs
Search the Expo documentation with intelligent ranking.
Parameters:
query(string, required): Search querysection(string, optional): Filter by section (e.g., 'guides', 'router', 'versions')maxResults(number, optional): Max results (default: 10)
Example:
{
"query": "camera permissions",
"section": "guides",
"maxResults": 5
}2. get_expo_doc_content
Get the full content of a specific documentation page.
Parameters:
path(string, required): Document path (e.g.,/versions/latest/sdk/camera)
Example:
{
"path": "/get-started/introduction"
}3. list_expo_sections
List all documentation sections or get documents in a specific section.
Parameters:
section(string, optional): Get documents in this section
Example:
{
"section": "router"
}4. get_expo_api_reference
Get API reference for a specific Expo SDK module.
Parameters:
module(string, required): Module name (e.g., 'camera', 'expo-camera')version(string, optional): SDK version (e.g., 'latest', 'v55.0.0', or '55.0.0')
Example:
{
"module": "camera"
}5. get_expo_quick_start
Get quick start documentation.
Parameters:
topic(string, optional): Specific topic (e.g., 'create-a-project')
Example:
{
"topic": "create-a-project"
}šļø Architecture
expo-local-docs-mcp/
āāā src/
ā āāā server.ts # MCP server implementation
ā āāā config.ts # Configuration management
ā āāā diskCache.ts # Disk cache management
ā āāā mdxParser.ts # MDX file parser (frontmatter + content)
ā āāā searchIndex/ # Search index module
ā ā āāā index.ts # Public API exports
ā ā āāā types.ts # TypeScript types
ā ā āāā state.ts # Index state management
ā ā āāā loader.ts # Index building and loading
ā ā āāā search.ts # Search algorithm
ā ā āāā query.ts # Document queries
ā ā āāā fileUtils.ts # File system utilities
ā āāā tools/ # MCP tool handlers
ā āāā definitions.ts # Tool schemas
ā āāā handlers/ # Tool implementations
ā āāā index.ts # Handler dispatcher
ā āāā types.ts # Handler types
ā āāā searchExpoDocs.ts
ā āāā getExpoDocContent.ts
ā āāā listExpoSections.ts
ā āāā getExpoApiReference.ts
ā āāā getExpoQuickStart.ts
āāā expo-sdk/ # Your Expo documentation .mdx files
ā āāā get-started/
ā āāā guides/
ā āāā router/
ā āāā versions/
ā āāā ...
āāā .expo-cache/ # Generated cache (auto-created)
ā āāā search-index.json
āāā dist/ # Built server
ā āāā server.js
āāā test-server.ts # Basic functionality tests
āāā test-tools.ts # Comprehensive tool tests
āāā package.jsonš§ Development
# Run in development mode
bun run dev
# Build for production
bun run build
# Start built server
bun run start
# Run tests
bun run test
bun run test:tools
bun run test:all
# Clear cache (force rebuild)
bun run clear-cachešÆ Environment Variables
Variable | Default | Description |
|
| Path to expo-sdk folder containing .mdx files |
|
| Cache directory location |
|
| Max search results to return |
|
| Cache age in ms (24 hours) |
š¦ Dependencies
@modelcontextprotocol/sdk- MCP protocol implementation@types/node- TypeScript Node.js typestypescript- TypeScript compiler
That's it! No HTTP clients, no HTML parsers, just fast file I/O.
š Troubleshooting
Index not building
Ensure
expo-sdk/folder exists and contains.mdxfilesCheck file permissions on the directory
Try
bun run clear-cacheand restart
Search returning no results
Wait for index to build (check console output)
Verify .mdx files have content
Try broader search terms
Cache rebuilding every time
Check
.expo-cache/folder permissionsVerify cache file is being created:
ls -lh .expo-cache/Check disk space
"Cannot find module" errors
Run
bun installto ensure dependencies are installedRun
bun run buildto rebuild
š How It Works
Startup: Server initializes and attempts to load from disk cache
Cache Check: Cache is valid only when version, age, and docs fingerprint all match (typically ~12-20ms load)
Fresh Build: If no valid cache, scans
expo-sdk/recursively for all.mdxfiles (currently 997 files)Parsing: Extracts YAML frontmatter and strips MDX/JSX to get clean text content
Indexing: Builds in-memory search index with path mapping (~90-120ms)
Caching: Saves complete index to
search-index.json(~4.4MB)Search: Uses optimized scoring algorithm (exact matches > word matches)
MDX Parsing
Each .mdx file's frontmatter is parsed:
---
title: Camera
description: A React component that renders a preview...
packageName: expo-camera
platforms: ["android", "ios", "web"]
---This metadata is used for better search results and filtering.
Search Scoring Algorithm
The search uses a dual-layer scoring system for maximum relevance:
Exact Phrase Matches:
Title contains exact query: 1000 points
Description contains exact query: 500 points
Path contains exact query: 300 points
Content contains exact query: 100 points
Individual Word Matches (with boundary detection):
Word match in title: 50 points per occurrence
Word match in description: 25 points per occurrence
Word match in path: 15 points per occurrence
Word match in content: 1 point per occurrence
Performance Optimizations:
Pre-compiles escaped regex patterns for each search word
Uses
for...ofloop instead of.map()for better performanceOnly creates scored objects for entries with matches (score > 0)
Single-pass algorithm with early section filtering
š Updating Documentation
To update the Expo docs:
Replace/update files in
expo-sdk/folderClear the cache:
bun run clear-cacheRestart the MCP server
The index will automatically rebuild on next startup.
ā FAQ
Q: Should I use npx or install globally?
A: Global install (npm install -g) is recommended for faster startup and cleaner config. Use npx if you want automatic updates.
Q: How do I update to the latest version?
A:
npx: Automatic (always uses latest)
Global:
npm update -g expo-local-docs-mcpLocal:
npm update expo-local-docs-mcpin your project
Q: How do I test npx execution?
A: Run npx expo-local-docs-mcp directly in your terminal. It should start the MCP server on stdio.
Q: Do I need the localhost:3002 server running?
A: No! That was the old v1.x architecture. v2.0 reads files directly.
Q: Can I delete the cache folder?
A: Yes! It will automatically rebuild (typically ~90-120ms). Cache locations:
npm/npx:
/tmp/expo-local-docs-mcp-cache/(macOS/Linux)Local dev:
.expo-cache/(project root)
Q: What happens if an .mdx file is missing?
A: The server gracefully skips it and continues indexing other files.
Q: Can I use this with Node.js instead of Bun?
A: Yes! The npm package is built to work with Node.js. Local development can use either Bun or Node.
Q: How big is the npm package?
A: It depends on the included docs snapshot. The current repo snapshot indexes 997 .mdx docs and builds a ~4.4MB cache file.
š Indexed Content
Total documents: 997 .mdx files
Total sections: 40
Cache size: ~4.4MB
Top sections:
- versions: 602 docs (SDK API references)
- guides: 59 docs
- router: 47 docs (Expo Router)
- eas: 35 docs (EAS services)
- eas-update: 27 docs
- tutorial: 25 docs
- develop: 21 docs
- build-reference: 21 docs
- archive: 18 docs
- modules: 17 docsš Benefits vs v1.x
Feature | v1.x (HTTP) | v2.0 (Files) |
Speed (first run) | 5-10s | 90-120ms |
Speed (cached) | 1-2s | 12-20ms |
Network required | Yes | No |
Dependencies | axios, cheerio | None |
HTTP server needed | Yes (localhost:3002) | No |
Offline support | No | Yes |
Search quality | Good | Better |
š License
MIT
š¤ Contributing
This is a personal MCP server optimized for local Expo documentation access. Feel free to fork and adapt for your needs!
Version: 2.0.5
Built with: Bun + TypeScript
Performance: š Blazing Fast
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Your Expo and EAS project in natural language: up to date SDK docs, cloud builds (status, logs, trig
Search and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.
Versioned documentation registry and semantic search for AI tools and coding assistants.
Grounded search over chinaready.co ā practical guides for launching software in Mainland China (ICP filing, app-store publishing, China cloud regions, payments). Three read-only tools: hybrid search, topic catalog, and full articles as Markdown. Every result carries an absolute source URL so answers can be cited. Free, no account, no keys.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables semantic search and retrieval over local Markdown/MDX documentation using Node.js-based embeddings. Supports multi-language documentation with offline vector indexing and MCP tool exposure for AI assistants.28 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered semantic search through Expo SDK documentation across multiple versions (v51-v53 and latest), allowing developers to quickly find relevant documentation with configurable similarity scoring.2MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to access and search Expo documentation with semantic search and AI-enhanced code examples and explanations using Gemini AI.33MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform semantic search over React Native documentation, retrieve specific pages, and manage doc versions locally without API keys.8 npmMIT