@denisixnpm/planka-mcp 2.2.0

package/dist/tools/types.js

@@ -0,0 +1,64 @@
+/**
+ * Tool definition for Planka MCP server
+ * Supports grouped tools with multiple actions/operations
+ */
+/**
+ * Helper to build input schema for grouped tools
+ */
+export function buildGroupedSchema(actions, actionDescriptions, params) {
+    const properties = {
+        action: {
+            type: "string",
+            enum: actions,
+            description: `Action to perform: ${actions.map(a => `'${a}' - ${actionDescriptions[a]}`).join("; ")}`,
+        },
+    };
+    if (params?.id) {
+        properties.id = {
+            type: "string",
+            description: params.id.description + (params.id.requiredFor ? ` (required for: ${params.id.requiredFor.join(", ")})` : ""),
+        };
+    }
+    if (params?.data) {
+        const dataSchema = {
+            type: "object",
+            description: params.data.description + (params.data.requiredFor ? ` (required for: ${params.data.requiredFor.join(", ")})` : ""),
+            additionalProperties: true,
+        };
+        if (params.data.properties) {
+            const fields = {};
+            const required = [];
+            for (const [fieldName, fieldDef] of Object.entries(params.data.properties)) {
+                const field = { type: fieldDef.type, description: fieldDef.description ?? "" };
+                if (fieldDef.enum) {
+                    field.enum = fieldDef.enum;
+                }
+                fields[fieldName] = field;
+                if (fieldDef.required) {
+                    required.push(fieldName);
+                }
+            }
+            dataSchema.properties = fields;
+            if (required.length > 0) {
+                dataSchema.required = required;
+            }
+        }
+        properties.data = dataSchema;
+    }
+    if (params?.query) {
+        properties.query = {
+            type: "object",
+            description: "Query parameters for filtering/pagination",
+            properties: params.query,
+        };
+    }
+    properties.raw = {
+        type: "boolean",
+        description: "Return the raw Planka API payload instead of the condensed agent view",
+    };
+    return {
+        type: "object",
+        properties,
+        required: ["action"],
+    };
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@denisixnpm/planka-mcp",
+  "version": "2.2.0",
+  "description": "MCP server for Planka - Real-Time Collaborative Kanban Board",
+  "main": "dist/server.js",
+  "type": "module",
+  "bin": {
+    "planka-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "start:sse": "MCP_TRANSPORT=sse node dist/server.js",
+    "dev": "bun src/server.ts",
+    "dev:sse": "MCP_TRANSPORT=sse bun src/server.ts",
+    "prepublishOnly": "npm run build",
+    "test": "bun run build && bun test",
+    "test:tools": "bun test test/tools.test.ts",
+    "test:build": "bun run build && bun test test/build.test.ts",
+    "test:server": "bun test test/server.test.ts",
+    "test:ci": "bun run build && bun test"
+  },
+  "keywords": [
+    "mcp",
+    "planka",
+    "kanban",
+    "model-context-protocol"
+  ],
+  "author": "Christopher Maldonado <chmald@microsoft.com> (original author)",
+  "contributors": [
+    "denisix (https://github.com/denisix)"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/denisix/planka-mcp.git"
+  },
+  "homepage": "https://github.com/denisix/planka-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/denisix/planka-mcp/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2"
+  }
+}