Skip to content
MCP server

Flisk

Start, check and fix a multi-service local app from one command, for you or your agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
1.4.56
Listing updated
3 days ago

About Flisk

Flisk is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Flisk is a command-line tool that runs every part of an app (API, website, workers, database) on your computer. It can import a docker-compose.yml or generate Dockerfiles, a Compose file and a Tiltfile from a small service.json. Small apps run as plain local processes without Docker, and larger ones get containers, one gateway address and live reload on the Docker and Tilt path.

Its MCP server exposes tools such as doctor, up, status, logs and down. The site shows one recorded run where status showed two unhealthy services, logs named a missing DATABASE_URL, and the agent fixed the code and restarted. flisk connect claude wires Claude Code, Cursor or Codex to the server.

It is MIT licensed, collects no telemetry, and does not deploy. Windows runs the full stack under WSL2.

Install

Run in a terminal

claude mcp add flisk -- npx -y @flisk-sh/flisk

Add to claude_desktop_config.json

{
  "mcpServers": {
    "flisk": {
      "command": "npx",
      "args": [
        "-y",
        "@flisk-sh/flisk"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "flisk": {
      "command": "npx",
      "args": [
        "-y",
        "@flisk-sh/flisk"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "flisk": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@flisk-sh/flisk"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "flisk": {
      "command": "npx",
      "args": [
        "-y",
        "@flisk-sh/flisk"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "flisk": {
      "command": "npx",
      "args": [
        "-y",
        "@flisk-sh/flisk"
      ]
    }
  }
}

Tools this server provides (5)

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

doctor
Check the machine and rank failing checks.
up
Start the local stack.
status
Report service health.
logs
Read recent service logs.
down
Stop the stack.

What it does

Compose import
`flisk import` reads an existing Compose file and keeps ports, names and env.
Health-aware start
`up --wait` returns only when the stack is healthy.
Targeted diagnostics
Show only failing services and their recent logs.
Doctor checks
Ranks failing machine checks by what blocks you most.
Generated stack
Dockerfiles, Compose and Tiltfile produced from one file.
Agent connect
One command registers the MCP server, skills and an AGENTS.md.

Good for

  • Bring up a multi-service app with one command
  • Let an agent diagnose an unhealthy service from logs
  • Restart one service without stopping the rest
  • Scaffold a new project with a chosen framework and database

Pricing

Open source

Free, MIT licensed

Prices change. Check flisk.sh before you buy.

Flisk FAQ

Does it require Docker?

No. Small apps run as local processes; Docker and Tilt are used for larger stacks.

Does it deploy my app?

No, production stays with your own tools.

What is the license?

MIT, with no telemetry.

What Node version is needed?

Node.js 22.12 or newer.

Is Flisk free?

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

How do I add Flisk to Claude Code?

Run this command in your terminal: claude mcp add flisk -- npx -y @flisk-sh/flisk

What are the best alternatives to Flisk?

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

Alternatives to Flisk

  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