@appolabs/appo-mcp

MCP (Model Context Protocol) server for improving developer experience when integrating the @appolabs/appo SDK into web applications.

Features

This MCP server provides AI assistants with tools, resources, and prompts to help developers:

• Generate Code - Create hooks, components, and scaffolding for SDK features
• Validate Setup - Check SDK installation and configuration
• Search Documentation - Access API reference, examples, and best practices
• Debug Issues - Diagnose and fix common integration problems

Installation

For Claude Code / Cursor

Add to your .mcp.json:

{
  "mcpServers": {
    "appo": {
      "command": "npx",
      "args": ["-y", "@appolabs/appo-mcp"]
    }
  }
}

For Development

git clone https://github.com/appolabs/appo-mcp.git
cd appo-mcp
pnpm install
pnpm build
pnpm start

Available Tools

Code Generation

Tool	Description
generate_hook	Generate a React hook for any SDK feature
generate_component	Generate a UI component with SDK integration
scaffold_feature	Scaffold complete feature with hook, component, and types

Validation

Tool	Description
validate_setup	Validate SDK installation and configuration
check_permissions	Analyze permission handling patterns
diagnose_issue	Diagnose common SDK integration issues

Available Resources

URI	Description
appo://overview	SDK overview and capabilities
appo://api/{feature}	API reference for each feature
appo://examples/{feature}	Code examples per feature
appo://best-practices	Integration best practices
appo://troubleshooting	Common issues and solutions

Features: push, biometrics, camera, location, haptics, storage, share, network, device

Available Prompts

Prompt	Description
setup_wizard	Interactive setup guidance for new/existing projects
integrate_feature	Step-by-step feature integration guide
debug_assistant	Troubleshooting assistant for SDK issues

Usage Examples

Generate a Hook

Ask your AI assistant:

"Generate a push notifications hook using the appo SDK"

The assistant will use generate_hook with feature: "push".

Validate Setup

"Check if my @appolabs/appo setup is correct"

The assistant will use validate_setup with your package.json.

Debug an Issue

"Push notifications always return denied"

The assistant will use diagnose_issue and check_permissions to help.

SDK Features

The @appolabs/appo SDK provides access to:

• Push Notifications - Request permission, get tokens, receive notifications
• Biometrics - Face ID / Touch ID authentication
• Camera - Capture photos
• Location - GPS coordinates
• Haptics - Tactile feedback
• Storage - Persistent key-value storage
• Share - Native share sheet
• Network - Connectivity status
• Device - Platform and device info

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Watch mode
pnpm dev

# Run server
pnpm start

# Type check
pnpm typecheck

# Test
pnpm test

License

MIT