Skip to content
MCP server

AppCrane

Deploy and manage apps on your own self-hosted AppCrane server through an agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
1.8.2
Listing updated
3 days ago

About AppCrane

AppCrane is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

AppCrane is a self-hosted platform for apps built with AI, and this connector is the stdio bridge that lets an agent operate it. There is no hosted service or AppCrane account: you run AppCrane (AGPL-3.0) on a server you control, create an API key there, and the connector forwards each tool call to your instance's /api/mcp endpoint with that key.

Without any configuration the package still starts and answers tools/list from a bundled catalog of 74 tools, so registries can inspect it offline; calls need APPCRANE_URL and APPCRANE_KEY. An optional GitHub token unlocks github_* passthrough tools. Examples named on the site include appcrane_create_app and appcrane_deploy.

The platform behind it deploys to sandbox first and needs an explicit per-app permission for production. Each app runs in its own Docker container, and every action is logged against the user and tagged agent or human. The site says it is aligned with SOC 2 controls but is not audited or certified. The connector itself is MIT licensed and needs Node 20 or newer.

Install

Run in a terminal

claude mcp add appcrane --env APPCRANE_KEY='<APPCRANE_KEY>' --env APPCRANE_GITHUB_TOKEN='<APPCRANE_GITHUB_TOKEN>' -- npx -y appcrane-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "appcrane": {
      "command": "npx",
      "args": [
        "-y",
        "appcrane-mcp"
      ],
      "env": {
        "APPCRANE_KEY": "<APPCRANE_KEY>",
        "APPCRANE_GITHUB_TOKEN": "<APPCRANE_GITHUB_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "appcrane": {
      "command": "npx",
      "args": [
        "-y",
        "appcrane-mcp"
      ],
      "env": {
        "APPCRANE_KEY": "<APPCRANE_KEY>",
        "APPCRANE_GITHUB_TOKEN": "<APPCRANE_GITHUB_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "appcrane": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "appcrane-mcp"
      ],
      "env": {
        "APPCRANE_KEY": "<APPCRANE_KEY>",
        "APPCRANE_GITHUB_TOKEN": "<APPCRANE_GITHUB_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "appcrane": {
      "command": "npx",
      "args": [
        "-y",
        "appcrane-mcp"
      ],
      "env": {
        "APPCRANE_KEY": "<APPCRANE_KEY>",
        "APPCRANE_GITHUB_TOKEN": "<APPCRANE_GITHUB_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "appcrane": {
      "command": "npx",
      "args": [
        "-y",
        "appcrane-mcp"
      ],
      "env": {
        "APPCRANE_KEY": "<APPCRANE_KEY>",
        "APPCRANE_GITHUB_TOKEN": "<APPCRANE_GITHUB_TOKEN>"
      }
    }
  }
}

Configuration

  • APPCRANE_URLBase URL of your own AppCrane instance, e.g. https://crane.example.com. Without it the connector still starts and answers tools/list from the bundled catalog, but cannot execute tools.
  • APPCRANE_KEYYour AppCrane API key, sent to the instance as the X-API-Key header. Required to execute tools.
  • APPCRANE_GITHUB_TOKENOptional GitHub personal access token, sent as X-Github-Token, to unlock the github_* passthrough tools.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

appcrane_create_app
Creates an app on the AppCrane instance and wires its route.
appcrane_deploy
Deploys an app to a stage such as sandbox, with clone, build and health check.

What it does

Bundled tool catalog
Lists 74 tools offline with zero configuration.
Live instance proxy
Forwards tool calls to your own AppCrane server with an API key.
Sandbox-first deploys
Deploys go to sandbox unless an app has production permission.
Audit attribution
Records actions against the user and marks them agent or human.
Per-app isolation
Runs each app in its own container.
GitHub passthrough
An optional token enables github_* tools.
Docker image
Can run as a container for introspection or full use.

Good for

  • Have an agent create and deploy an app to a sandbox
  • Promote a tested commit to production and roll back if needed
  • Set app secrets through an agent without exposing them in chat
  • Install an open-source catalogue app on your own server
  • Audit which agent or person changed a deployment

Pricing

Open source

Connector MIT; platform AGPL-3.0, free to self-host

Prices change. Check glick.run before you buy.

AppCrane FAQ

Is there a hosted AppCrane service?

No. The README says there is no hosted service or account; you self-host.

Which variables are required?

APPCRANE_URL and APPCRANE_KEY for tool calls; APPCRANE_GITHUB_TOKEN is optional.

What are the licences?

The connector is MIT; the AppCrane platform is AGPL-3.0.

Can I list tools without an instance?

Yes, it serves the bundled 74-tool catalog.

What are the runtime requirements?

Node 20 or newer; the platform targets Ubuntu 22.04+.

Is AppCrane free?

Yes. AppCrane is open source, so you can use and self-host it for free.

How do I add AppCrane to Claude Code?

Run this command in your terminal: claude mcp add appcrane --env APPCRANE_KEY='<APPCRANE_KEY>' --env APPCRANE_GITHUB_TOKEN='<APPCRANE_GITHUB_TOKEN>' -- npx -y appcrane-mcp

What are the best alternatives to AppCrane?

The closest alternatives to AppCrane are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to AppCrane

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools