# AppCrane

> AppCrane is an open-source MCP server for cloud and infrastructure. Deploy and manage apps on your own self-hosted AppCrane server through an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API, Linux
- **Website:** https://glick.run/appcrane.html
- **Repository:** https://github.com/gitayg/appcrane-mcp
- **MCP Registry name:** io.github.gitayg/appcrane
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/appcrane
