@appolabs/appo-mcp

Name: Appo MCP
Availability: InStock

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

Appo MCP