# @aixlab/kanbn-mcp

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for the [Kan](https://kan.bn) Kanban API. Allows AI assistants like Claude, Cursor, and others to interact with your Kan boards directly.

## Installation

### Via npx (recommended – no installation needed)

```bash
npx @aixlab/kanbn-mcp
```

### Global install

```bash
npm install -g @aixlab/kanbn-mcp
kanbn-mcp
```

## Configuration

The server requires the following environment variables:

| Variable | Description |
|---|---|
| `API_BASE_URL` | Base URL of your Kan instance (e.g. `https://kan.example.com/api`) |
| `BEARER_TOKEN_AUTHORIZATION` | Your Kan API key |

You can set these in a `.env` file or pass them directly as environment variables.

## Usage with Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "kan": {
      "command": "npx",
      "args": ["-y", "@aixlab/kanbn-mcp"],
      "env": {
        "API_BASE_URL": "https://kan.example.com/api",
        "BEARER_TOKEN_AUTHORIZATION": "your-api-key-here"
      }
    }
  }
}
```

## Usage with VS Code (GitHub Copilot)

Add this to your `.vscode/mcp.json`:

```json
{
  "servers": {
    "kan": {
      "command": "npx",
      "args": ["-y", "@aixlab/kanbn-mcp"],
      "env": {
        "API_BASE_URL": "https://kan.example.com/api",
        "BEARER_TOKEN_AUTHORIZATION": "your-api-key-here"
      }
    }
  }
}
```

## License

MIT