chmald/planka-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

6 stars 3 forks 품질 72 트렌드 14MIT

MCP server for Planka - enables AI assistants to interact with Planka kanban boards via Model Context Protocol. Supports multi-client connections via SSE.

개요

An MCP server that enables AI assistants (Claude, VS Code Copilot, etc.) to interact with Planka - a real-time Kanban board application. - or - running and accessible - with appropriate permissions Use host.docker.internal instead of localhost when running Docker. * Authentication is required. Provide either PLANKA_API_KEY, or both PLANKA_USERNAME and PLANKA_PASSWORD. - Set PLANKA_API_KEY. - Set PLANKA_USERNAME and PLANKA_PASSWORD. - If both are set, the server uses PLANKA_API_KEY. - Retries apply to transient failures (408, 429, 5xx) and network request errors. - Delay uses exponential backoff: PLANKA_HTTP_RETRY_BASE_DELAY_MS * 2^attempt. - PLANKA_HTTP_MAX_RETRIES controls additional attempts after the initial request. By default, are enabled for essential Kanban operations: Each tool uses an action parameter. Example: { "action": "list" } or { "action": "get", "id": "123" }

README

원문 README의 일부입니다. 원문 보기.

Planka MCP Server

An MCP server that enables AI assistants (Claude, VS Code Copilot, etc.) to interact with Planka - a real-time Kanban board application.

Quick Start

Prerequisites

Node.js 18+ or Docker
Planka instance running and accessible
Planka user account with appropriate permissions

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@chmald/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "http://localhost:3000",
        "PLANKA_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "planka": {
      "type": "stdio",
      "command": "npx",
      "args": ["@chmald/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "http://localhost:3000",
        "PLANKA_API_KEY": "your-api-key"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "planka": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "PLANKA_BASE_URL=http://host.docker.internal:3000",
        "-e", "PLANKA_API_KEY=your-api-key",
        "chmald/planka-mcp:latest"
      ]
    }
  }
}

Note: Use host.docker.internal instead of localhost when running Docker.

Configuration

Environment Variables

Variable	Required	Default	Description
`PLANKA_BASE_URL`	Yes	`http://localhost:3000`	Your Planka instance URL
`PLANKA_API_KEY`	No*	-	Planka API key sent as `X-Api-Key`
`PLANKA_USERNAME`	No*	-	Planka username or email
`PLANKA_PASSWORD`	No*	-	Planka password
`MCP_TRANSPORT`	No	`stdio`	MCP transport mode: `stdio` or `sse`
`MCP_PORT`	No	`3001`	HTTP port used when `MCP_TRANSPORT=sse`
`PLANKA_HTTP_MAX_RETRIES`	No	`2`	Max retry attempts for transient HTTP/network failures per request
`PLANKA_HTTP_RETRY_BASE_DELAY_MS`	No	`250`	Base retry delay in milliseconds (exponential backoff)
`ENABLE_ALL_TOOLS`	No	`false`	Enable all 27 tools
`ENABLE_ADMIN_TOOLS`	No	`false`	Enable admin tools
`ENABLE_OPTIONAL_TOOLS`	No	`false`	Enable optional tools

* Authentication is required. Provide either PLANKA_API_KEY, or both PLANKA_USERNAME and PLANKA_PASSWORD.

Authentication Modes

API key (recommended): Set PLANKA_API_KEY.
Username/password: Set PLANKA_USERNAME and PLANKA_PASSWORD.
If both are set, the server uses PLANKA_API_KEY.

Retry Behavior

GitHub에서 전체 README 보기

설치

npx @chmald/planka-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@chmald/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "http://localhost:3000",
        "PLANKA_API_KEY": "your-api-key"
      }
    }
  }
}