@zeabur/mcp-server

Zeabur MCP Server

A Model Context Protocol (MCP) server for Zeabur, built with TypeScript using @zeabur/ai-sdk.

Installation

From npm

npm install -g @zeabur/mcp-server

From source

git clone https://github.com/zeabur/mcp-server.git
cd mcp-server
npm install
npm run build

Setup

Get your API token from the API keys page.

Claude Code

claude mcp add zeabur -e ZEABUR_TOKEN="<YOUR_TOKEN>" -- npx zeabur-mcp

Or if installed from source:

claude mcp add zeabur -e ZEABUR_TOKEN="<YOUR_TOKEN>" -- node /path/to/mcp-server/dist/index.js

Claude Desktop

Open Settings > Edit Config, then add:

{
  "mcpServers": {
    "zeabur": {
      "command": "npx",
      "args": ["zeabur-mcp"],
      "env": {
        "ZEABUR_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Cursor

Open ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "zeabur": {
      "command": "npx",
      "args": ["zeabur-mcp"],
      "env": {
        "ZEABUR_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Available Tools

All tools are provided by @zeabur/ai-sdk.

Core

Tool	Description
execute-command	Execute any command on a prebuilt service
deploy-from-specification	Deploy a project from service specification

Projects

Tool	Description
list-projects	List all projects for the current user
create-project	Create a new project

Regions

Tool	Description
list-regions	List available regions and optionally dedicated servers

Services

Tool	Description
list-services	List all services in a project
get-service	Get details of a specific service including domains and dockerfile
create-service	Create a new service in a project

Ports

Tool	Description
update-service-ports	Update the exposed ports of a service

Domains

Tool	Description
add-domain	Add a domain to a service

Templates

Tool	Description
search-template	Search for deployment templates
deploy-template	Deploy a template to a project

User

Tool	Description
get-me	Get the current user's information

Git

Tool	Description
get-repo-id	Get the repo ID from a GitHub URL
search-git-repos	Search for Git repositories

Logs & Deployments

Tool	Description
get-build-logs	Get build logs for a specific deployment
get-runtime-logs	Get runtime logs for a specific service
get-deployments	Get deployments for a specific service

Filesystem

Tool	Description
decide-filesystem	Decide which filesystem to use (GitHub or Upload)
list-files	List files in the filesystem
read-file	Read content of a file in the filesystem
file-dir-read	Execute safe read-only commands on a service

Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Run
ZEABUR_TOKEN=<YOUR_TOKEN> npm start

License

MIT