# Flisk

> Flisk is an open-source MCP server for developer tools. Start, check and fix a multi-service local app from one command, for you or your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://flisk.sh
- **Repository:** https://github.com/flisk-sh/flisk
- **MCP Registry name:** io.github.flisk-sh/flisk
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [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/flisk
