@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