jaksm/expo-docs-mcp

Expo Docs MCP Server

MCP server for semantic search of pre-indexed Expo documentation. Search through Expo SDK documentation using AI-powered semantic search with version-specific results.

Features

• 🔍 Semantic Search: AI-powered search through Expo documentation
• 📚 Version-Specific: Search across different Expo SDK versions (v51, v52, v53, latest)
• ⚡ Fast Results: Pre-indexed documentation with HNSW vector search
• 🎯 Relevant Results: Similarity scoring and configurable result limits

Tools

search-expo-docs

Search Expo documentation using semantic search.

Parameters:

• query (string, required): The search query to find relevant Expo documentation
• version (string, required): Expo SDK version (v53, v52, v51, or latest)
• maxResults (number, optional): Maximum number of results to return (1-10, default: 5)
• scoreThreshold (number, optional): Minimum similarity score threshold (0.0-1.0, default: 0.0)

Example:

{
  "name": "search-expo-docs",
  "arguments": {
    "query": "how to use camera in expo",
    "version": "v53",
    "maxResults": 3
  }
}

Installation

Via Smithery (Recommended)

Install directly using the Smithery CLI:

npx -y @smithery/cli install expo-docs-mcp --client claude

Manual Installation for Claude Desktop

1. Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "expo-docs": {
      "command": "npx",
      "args": ["-y", "expo-docs-mcp"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

2. Restart Claude Desktop

Claude Code Installation

For Claude Code, you can use the built-in MCP configuration:

1. Via Smithery CLI (Recommended):

npx -y @smithery/cli install expo-docs-mcp --client claude-code

2. Manual Configuration:

# Add the MCP server to Claude Code
claude mcp add expo-docs npx -y expo-docs-mcp

# Set the OpenAI API key
claude mcp config set expo-docs OPENAI_API_KEY=your_openai_api_key_here

# Verify the configuration
claude mcp list

3. Alternative Local Build Method:

# Clone and build locally
git clone https://github.com/jaksm/expo-docs-mcp.git
cd expo-docs-mcp
npm install
npm run build

# Add to Claude Code
claude mcp add expo-docs node ./dist/mcp-server.js
claude mcp config set expo-docs OPENAI_API_KEY=your_openai_api_key_here

Environment Variables

• OPENAI_API_KEY: Required for generating text embeddings during search queries. The server uses OpenAI's text-embedding-3-large model to convert your search queries into vectors that can be matched against the pre-indexed Expo documentation vectors.

Development

# Clone the repository
git clone https://github.com/jaksm/expo-docs-mcp.git
cd expo-docs-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Test the MCP server connection
npm run test:mcp

# Run the server
npm start

# Development mode
npm run dev:server

Available Versions

• latest: Most recent Expo SDK documentation
• v53: Expo SDK 53
• v52: Expo SDK 52
• v51: Expo SDK 51

Usage Examples

In Claude Desktop or Claude Code

Once installed, you can ask questions about Expo documentation directly:

Camera-related queries:

How do I request camera permissions in Expo v53?

Navigation setup:

Show me how to set up React Navigation with Expo Router in the latest version

Build configuration:

What are the EAS build configuration options for iOS in Expo v52?

SDK-specific features:

What are the new features in Expo SDK 53?

Direct Tool Usage

If calling the tool directly, use this format:

{
  "name": "search-expo-docs",
  "arguments": {
    "query": "camera permissions and usage",
    "version": "v53",
    "maxResults": 3,
    "scoreThreshold": 0.1
  }
}

Architecture

• Semantic Search: Uses OpenAI embeddings with HNSW indexing
• Version Management: Separate indexes for each Expo SDK version
• Pre-processed Data: Documentation is pre-indexed for fast retrieval
• MCP Protocol: Standard Model Context Protocol implementation

License

MIT

Contributing

Contributions welcome! Please read the contributing guidelines and submit pull requests to the main branch.