planka-mcp/dist/index.js

A Model Context Protocol (MCP) server for managing Planka boards, cards, lists, and labels via CLI and NPX.

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { Planka } from "./lib/planka.js";
import { readdirSync } from "fs";
import { dirname, join, basename } from "path";
import { fileURLToPath } from "url";
import dotenv from 'dotenv';
dotenv.config();
// Create an MCP server
const server = new McpServer({
    name: "planka-mcp",
    version: "1.0.0"
});
// Validate required environment variables
const requiredEnv = [
    "PLANKA_EMAIL_OR_USERNAME",
    "PLANKA_PASSWORD",
    "PLANKA_API_URL"
];
const missingEnv = requiredEnv.filter((key) => !process.env[key]);
if (missingEnv.length > 0) {
    console.error(`\nERROR: Missing required environment variable(s): ${missingEnv.join(", ")}`);
    console.error("Please set them in your environment or .env file before starting the server.\n");
    process.exit(1);
}
// Initialize Planka instance
const planka = await Planka.init(process.env.PLANKA_EMAIL_OR_USERNAME, process.env.PLANKA_PASSWORD, process.env.PLANKA_API_URL);
// Dynamically import and register all tools in the tools directory (ESM compatible)
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const toolsDir = join(__dirname, "tools");
const toolFiles = readdirSync(toolsDir).filter((f) => f.endsWith(".js"));
for (const file of toolFiles) {
    const toolModule = await import(join(toolsDir, file));
    // Assume each tool exports a default function or named function matching the filename
    // Pass server and planka to each tool
    if (typeof toolModule.default === "function") {
        toolModule.default(server, planka);
    }
    else {
        // Try to find a named export matching the filename (without extension)
        const toolName = basename(file, ".js");
        if (typeof toolModule[toolName] === "function") {
            toolModule[toolName](server, planka);
        }
    }
}
// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);
planka.createTaskList("1561645384764228964", "Wizard Steps & Requirements", true, 1);