home / mcp / appo mcp server

Appo MCP Server

Provides an MCP server to assist developers with generation, validation, documentation access, and debugging for the Appo SDK.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You deploy and use the Appo MCP Server to streamline developer onboarding for the Appo SDK. It provides AI-assisted generation, validation, documentation access, and debugging helpers that speed up building, integrating, and troubleshooting features across web applications.

How to use

You interact with the MCP client to run specialized tools that help you develop with the Appo SDK. Use the available actions to generate hooks and components, scaffold complete features, validate your setup, diagnose issues, and search documentation. Specify the feature you are working with, and the assistant will perform the corresponding tool operation to produce code, configuration checks, or guidance.

How to install

Prerequisites you need before installing the MCP server:

- Node.js and npm or a compatible package manager are installed on your machine.

Install or configure the MCP server using the following steps.

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

Additional content

Development workflow for running the MCP server locally starts with cloning the repository, installing dependencies, building, and starting the server. The typical flow is to install dependencies, build the project, and then start the server to accept MCP commands from your client.

Development commands you will use include the following sequence. Each command should be run in your terminal from the project root.

# Clone the repository
git clone https://github.com/appolabs/appo-mcp.git
cd appo-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

# Start the MCP server
pnpm start

# Optional: type check and tests
pnpm typecheck
pnpm test

Available tools

generate_hook

Create a React hook for a specific SDK feature to accelerate integration and usage.

generate_component

Generate a UI component wired to Appo SDK features for rapid UI development.

scaffold_feature

Set up a complete feature scaffold including hook, component, and types for a chosen SDK capability.

validate_setup

Check that the Appo SDK is installed and configured correctly in your project.

check_permissions

Analyze and assess permission handling patterns within your integration.

diagnose_issue

Diagnose common integration issues and provide actionable fixes.

setup_wizard

Interactive setup guidance for new or existing projects.

integrate_feature

Step-by-step integration guidance for a specific feature.

debug_assistant

Troubleshooting assistant focused on resolving SDK-related problems.