# @mhdd_24/airflow-mcp

MCP server for DAGs, runs, logs and task failures.

Same architecture as [@mhdd_24/sublime-mcp](https://github.com/Mhdd-24/Sublime-MCP).

**Full documentation:** [docs/WIKI.md](./docs/WIKI.md)

---

## How it works (30 seconds)

```
You (chat) → MCP client → airflow-mcp → Airflow APIs / CLIs / local tools
```

---

## Prerequisites

| Requirement | Notes |
|-------------|--------|
| **Node.js 18+** | ESM TypeScript MCP server |
| **Credentials / CLIs** | See environment variables below |

---

## Install

### Option A — npm (after publish)

```bash
npm install -g @mhdd_24/airflow-mcp
```

### Option B — npx

```bash
npx @mhdd_24/airflow-mcp
```

### Option C — clone and build

```bash
git clone https://github.com/Mhdd-24/Airflow-MCP.git
cd Airflow-MCP
npm install
npm run build
node dist/index.js
```

---

## Configure Cursor

Edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "airflow": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/airflow-mcp"],
      "env": {
        "AIRFLOW_BASE_URL": "...",
        "AIRFLOW_USERNAME": "...",
        "AIRFLOW_PASSWORD": "..."
      }
    }
  }
}
```

**Local development:**

```json
{
  "command": "node",
  "args": ["/absolute/path/to/Airflow-MCP/dist/index.js"]
}
```

---

## Environment variables

| Variable | Description |
|----------|-------------|
| `AIRFLOW_BASE_URL` | Airflow URL |
| `AIRFLOW_USERNAME` | User |
| `AIRFLOW_PASSWORD` | Password |

---

## Tools

| Tool | Description |
|------|-------------|
| `airflow_status` | Show dags configuration / health. |
| `airflow_list` | List dags resources/items. |
| `airflow_get` | Get a dags resource by id/name. |
| `airflow_diagnose` | Diagnostics / checklist for dags. |

---

## License

ISC