@flowboardlabs/mcp-server 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,131 @@
+/**
+ * FlowBoard API client — thin HTTP wrapper over Cloud Functions endpoints.
+ */
+export declare class FlowBoardClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    private request;
+    listProjects(): Promise<{
+        projects: Project[];
+    }>;
+    searchTasks(filters?: TaskFilters): Promise<{
+        tasks: Task[];
+        filters: Record<string, unknown>;
+    }>;
+    getTask(taskId: string): Promise<{
+        task: Task;
+        comments: Comment[];
+    }>;
+    createTask(data: CreateTaskInput): Promise<{
+        id: string;
+        taskNumber: string;
+        message: string;
+    }>;
+    updateTask(taskId: string, data: UpdateTaskInput): Promise<{
+        success: boolean;
+        taskId: string;
+        message: string;
+    }>;
+    deleteTask(taskId: string): Promise<{
+        success: boolean;
+        taskId: string;
+        message: string;
+    }>;
+    getComments(taskId: string, limit?: number): Promise<{
+        comments: Comment[];
+        taskId: string;
+    }>;
+    addComment(taskId: string, text: string): Promise<{
+        commentId: string;
+        taskId: string;
+        message: string;
+    }>;
+    listReleases(limit?: number): Promise<{
+        releases: Release[];
+    }>;
+    getRelease(releaseId: string): Promise<{
+        release: Release;
+        tasks: Task[];
+    }>;
+    voteIdea(taskId: string): Promise<{
+        success: boolean;
+        taskId: string;
+        voted: boolean;
+        voteCount: number;
+        message: string;
+    }>;
+}
+export interface Project {
+    id: string;
+    name: string;
+    description: string | null;
+    color: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: string;
+    type: string;
+    taskNumber?: string;
+    tags?: string[];
+    assignee?: string;
+    projectId?: string;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    startedAt?: string | null;
+    doneAt?: string | null;
+    finishedAt?: string | null;
+    voteCount?: number;
+    [key: string]: unknown;
+}
+export interface Comment {
+    id: string;
+    text: string;
+    createdBy: string;
+    createdAt: string | null;
+    type: string;
+}
+export interface Release {
+    id: string;
+    name: string;
+    version: string | null;
+    status: string | null;
+    description: string | null;
+    releaseDate: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    taskCount?: number;
+}
+export interface TaskFilters {
+    board?: string;
+    status?: string;
+    statuses?: string[];
+    projectId?: string;
+    assignee?: string;
+    type?: string;
+    tags?: string[];
+    limit?: number;
+}
+export interface CreateTaskInput {
+    title: string;
+    description: string;
+    type: 'idea' | 'bug';
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateTaskInput {
+    status?: string;
+    comment?: string;
+    externalReference?: {
+        type: string;
+        url: string;
+        id?: string;
+        title?: string;
+    };
+    assignee?: string;
+    branchName?: string;
+}

package/dist/client.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * FlowBoard API client — thin HTTP wrapper over Cloud Functions endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowBoardClient = void 0;
+const DEFAULT_API_URL = 'https://europe-west3-flowwboard.cloudfunctions.net';
+class FlowBoardClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = (baseUrl || DEFAULT_API_URL).replace(/\/+$/, '');
+    }
+    async request(path, options = {}) {
+        const { method = 'GET', body, query } = options;
+        let url = `${this.baseUrl}/${path}`;
+        if (query) {
+            const params = new URLSearchParams(query);
+            url += `?${params.toString()}`;
+        }
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            const message = data.message ||
+                data.error ||
+                `HTTP ${res.status}`;
+            throw new Error(message);
+        }
+        return data;
+    }
+    // ---- Projects ----
+    async listProjects() {
+        return this.request('listProjects');
+    }
+    // ---- Tasks ----
+    async searchTasks(filters = {}) {
+        const query = {};
+        if (filters.board)
+            query.board = filters.board;
+        if (filters.status)
+            query.status = filters.status;
+        if (filters.statuses)
+            query.statuses = filters.statuses.join(',');
+        if (filters.projectId)
+            query.projectId = filters.projectId;
+        if (filters.assignee)
+            query.assignee = filters.assignee;
+        if (filters.type)
+            query.type = filters.type;
+        if (filters.tags)
+            query.tags = filters.tags.join(',');
+        if (filters.limit)
+            query.limit = String(filters.limit);
+        return this.request('getTasks', { query });
+    }
+    async getTask(taskId) {
+        return this.request('getTask', { query: { taskId } });
+    }
+    async createTask(data) {
+        return this.request('submitTask', { method: 'POST', body: data });
+    }
+    async updateTask(taskId, data) {
+        return this.request('updateTask', { method: 'PATCH', body: data, query: { taskId } });
+    }
+    async deleteTask(taskId) {
+        return this.request('deleteTask', { method: 'DELETE', query: { taskId } });
+    }
+    // ---- Comments ----
+    async getComments(taskId, limit) {
+        const query = { taskId };
+        if (limit)
+            query.limit = String(limit);
+        return this.request('getComments', { query });
+    }
+    async addComment(taskId, text) {
+        return this.request('addComment', { method: 'POST', body: { text }, query: { taskId } });
+    }
+    // ---- Releases ----
+    async listReleases(limit) {
+        const query = {};
+        if (limit)
+            query.limit = String(limit);
+        return this.request('listReleases', { query });
+    }
+    async getRelease(releaseId) {
+        return this.request('getRelease', { query: { releaseId } });
+    }
+    // ---- Ideas ----
+    async voteIdea(taskId) {
+        return this.request('voteIdea', { method: 'POST', query: { taskId } });
+    }
+}
+exports.FlowBoardClient = FlowBoardClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const client_js_1 = require("./client.js");
+const tools_js_1 = require("./tools.js");
+const API_KEY = process.env.FLOWBOARD_API_KEY;
+const API_URL = process.env.FLOWBOARD_API_URL;
+if (!API_KEY) {
+    console.error('Error: FLOWBOARD_API_KEY environment variable is required.');
+    console.error('Generate one at: FlowBoard → Settings → Integrations → API Keys');
+    process.exit(1);
+}
+const client = new client_js_1.FlowBoardClient(API_KEY, API_URL);
+const server = new mcp_js_1.McpServer({
+    name: 'flowboard',
+    version: '0.1.0',
+});
+// ---- Register tools ----
+for (const def of tools_js_1.TOOL_DEFINITIONS) {
+    server.tool(def.name, def.description, def.inputSchema, async (args) => {
+        try {
+            const result = await (0, tools_js_1.executeTool)(client, def.name, args);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ---- Register resources ----
+// Static resource: list of projects
+server.resource('projects', 'flowboard://projects', { description: 'List of all projects in the workspace' }, async () => {
+    const result = await client.listProjects();
+    return {
+        contents: [
+            {
+                uri: 'flowboard://projects',
+                mimeType: 'application/json',
+                text: JSON.stringify(result.projects, null, 2),
+            },
+        ],
+    };
+});
+// Dynamic resource: individual task by ID
+server.resource('task', new mcp_js_1.ResourceTemplate('flowboard://tasks/{taskId}', { list: undefined }), { description: 'A single FlowBoard task with its comments' }, async (uri, params) => {
+    const taskId = params.taskId;
+    const result = await client.getTask(taskId);
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// ---- Start server ----
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+import { FlowBoardClient } from './client.js';
+/**
+ * Tool definitions for the FlowBoard MCP server.
+ * Each tool maps to one or more FlowBoard API calls.
+ */
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare const TOOL_DEFINITIONS: ToolDef[];
+/**
+ * Execute an MCP tool call against the FlowBoard API.
+ */
+export declare function executeTool(client: FlowBoardClient, toolName: string, args: Record<string, unknown>): Promise<unknown>;

package/dist/tools.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITIONS = void 0;
+exports.executeTool = executeTool;
+exports.TOOL_DEFINITIONS = [
+    // ---- Projects ----
+    {
+        name: 'list_projects',
+        description: 'List all projects in the FlowBoard workspace.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    // ---- Tasks ----
+    {
+        name: 'search_tasks',
+        description: 'Search and filter tasks. Supports filtering by board (flow/bugs/ideas), status, project, assignee, type, and tags.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                board: { type: 'string', description: 'Board to search: "flow", "bugs", or "ideas"' },
+                status: { type: 'string', description: 'Filter by status: open, in_progress, blocked, ready, done, paused' },
+                statuses: { type: 'string', description: 'Comma-separated list of statuses' },
+                projectId: { type: 'string', description: 'Filter by project ID' },
+                assignee: { type: 'string', description: 'Filter by assignee email or ID' },
+                type: { type: 'string', description: 'Filter by type: idea, bug, task' },
+                tags: { type: 'string', description: 'Comma-separated list of tags to filter by' },
+                limit: { type: 'number', description: 'Max results (default 100, max 500)' },
+            },
+        },
+    },
+    {
+        name: 'get_task',
+        description: 'Get a single task by ID, including its comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The task ID' },
+            },
+            required: ['taskId'],
+        },
+    },
+    {
+        name: 'create_task',
+        description: 'Create a new task (idea or bug) in FlowBoard.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Task title (3-200 characters)' },
+                description: { type: 'string', description: 'Task description (0-5000 characters)' },
+                type: { type: 'string', enum: ['idea', 'bug'], description: 'Task type: idea or bug' },
+                tags: { type: 'string', description: 'Comma-separated tags (max 10, each max 50 chars)' },
+            },
+            required: ['title', 'description', 'type'],
+        },
+    },
+    {
+        name: 'update_task',
+        description: 'Update a task — change status, add a comment, link a PR/MR, assign someone, or set a branch name.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The task ID to update' },
+                status: { type: 'string', description: 'New status: open, in_progress, blocked, ready, done, paused' },
+                comment: { type: 'string', description: 'Comment to add (1-5000 characters)' },
+                assignee: { type: 'string', description: 'Assignee email or ID' },
+                branchName: { type: 'string', description: 'Git branch name (max 200 chars)' },
+                externalReferenceType: { type: 'string', description: 'External ref type, e.g. "github_pr", "gitlab_mr"' },
+                externalReferenceUrl: { type: 'string', description: 'External ref URL' },
+                externalReferenceTitle: { type: 'string', description: 'External ref title' },
+            },
+            required: ['taskId'],
+        },
+    },
+    {
+        name: 'delete_task',
+        description: 'Soft-delete (trash) a task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The task ID to delete' },
+            },
+            required: ['taskId'],
+        },
+    },
+    // ---- Ideas ----
+    {
+        name: 'list_ideas',
+        description: 'List ideas with optional status filter. Shortcut for search_tasks with board=ideas.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: { type: 'string', description: 'Filter by status' },
+                limit: { type: 'number', description: 'Max results (default 100)' },
+            },
+        },
+    },
+    {
+        name: 'vote_idea',
+        description: 'Toggle a vote on an idea. Voting again removes the vote.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The idea task ID to vote on' },
+            },
+            required: ['taskId'],
+        },
+    },
+    // ---- Releases ----
+    {
+        name: 'list_releases',
+        description: 'List releases in the workspace.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max results (default 25, max 100)' },
+            },
+        },
+    },
+    {
+        name: 'get_release',
+        description: 'Get a single release with its associated tasks.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', description: 'The release ID' },
+            },
+            required: ['releaseId'],
+        },
+    },
+    // ---- Comments ----
+    {
+        name: 'get_comments',
+        description: 'Get comments for a task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The task ID' },
+                limit: { type: 'number', description: 'Max comments (default 50, max 100)' },
+            },
+            required: ['taskId'],
+        },
+    },
+    {
+        name: 'add_comment',
+        description: 'Add a comment to a task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskId: { type: 'string', description: 'The task ID' },
+                text: { type: 'string', description: 'Comment text (1-5000 characters)' },
+            },
+            required: ['taskId', 'text'],
+        },
+    },
+];
+/**
+ * Execute an MCP tool call against the FlowBoard API.
+ */
+async function executeTool(client, toolName, args) {
+    switch (toolName) {
+        // Projects
+        case 'list_projects':
+            return client.listProjects();
+        // Tasks
+        case 'search_tasks': {
+            const filters = {};
+            if (args.board)
+                filters.board = args.board;
+            if (args.status)
+                filters.status = args.status;
+            if (args.statuses)
+                filters.statuses = args.statuses.split(',').map(s => s.trim());
+            if (args.projectId)
+                filters.projectId = args.projectId;
+            if (args.assignee)
+                filters.assignee = args.assignee;
+            if (args.type)
+                filters.type = args.type;
+            if (args.tags)
+                filters.tags = args.tags.split(',').map(s => s.trim());
+            if (args.limit)
+                filters.limit = args.limit;
+            return client.searchTasks(filters);
+        }
+        case 'get_task':
+            return client.getTask(args.taskId);
+        case 'create_task': {
+            const tags = args.tags ? args.tags.split(',').map(s => s.trim()) : undefined;
+            return client.createTask({
+                title: args.title,
+                description: args.description,
+                type: args.type,
+                tags,
+            });
+        }
+        case 'update_task': {
+            const update = {};
+            if (args.status)
+                update.status = args.status;
+            if (args.comment)
+                update.comment = args.comment;
+            if (args.assignee !== undefined)
+                update.assignee = args.assignee;
+            if (args.branchName !== undefined)
+                update.branchName = args.branchName;
+            if (args.externalReferenceType && args.externalReferenceUrl) {
+                update.externalReference = {
+                    type: args.externalReferenceType,
+                    url: args.externalReferenceUrl,
+                    title: args.externalReferenceTitle || undefined,
+                };
+            }
+            return client.updateTask(args.taskId, update);
+        }
+        case 'delete_task':
+            return client.deleteTask(args.taskId);
+        // Ideas
+        case 'list_ideas':
+            return client.searchTasks({
+                board: 'ideas',
+                status: args.status,
+                limit: args.limit,
+            });
+        case 'vote_idea':
+            return client.voteIdea(args.taskId);
+        // Releases
+        case 'list_releases':
+            return client.listReleases(args.limit);
+        case 'get_release':
+            return client.getRelease(args.releaseId);
+        // Comments
+        case 'get_comments':
+            return client.getComments(args.taskId, args.limit);
+        case 'add_comment':
+            return client.addComment(args.taskId, args.text);
+        default:
+            throw new Error(`Unknown tool: ${toolName}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@flowboardlabs/mcp-server",
+  "version": "0.1.0",
+  "description": "FlowBoard MCP Server — lets AI tools manage projects, tasks, ideas, and releases",
+  "main": "dist/index.js",
+  "bin": {
+    "flowboard-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": ["flowboard", "mcp", "ai", "project-management", "claude"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}