bugherd-mcp 0.1.0

package/.env.example

@@ -0,0 +1,3 @@
+# BugHerd API Key
+# Get your API key from BugHerd: Settings > General Settings
+BUGHERD_API_KEY=your-api-key-here

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Berckan Guerrero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# BugHerd MCP Server
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that integrates [BugHerd](https://bugherd.com) bug tracking with AI assistants like Claude.
+
+## Features
+
+- **List Projects** - View all BugHerd projects accessible to your account
+- **List Tasks** - Browse bugs and feedback with filtering by status, priority, and tags
+- **Get Task Details** - View complete task information including screenshots and element selectors
+- **List Comments** - Read conversation threads on tasks
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18+ or Bun
+- A BugHerd account with API access
+- BugHerd API key (get it from Settings > General Settings)
+
+### Setup
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/berckan/bugherd-mcp.git
+cd bugherd-mcp
+```
+
+2. Install dependencies:
+
+```bash
+bun install
+# or
+npm install
+```
+
+3. Build the server:
+
+```bash
+bun run build
+# or
+npm run build
+```
+
+4. Set your API key:
+
+```bash
+export BUGHERD_API_KEY=your-api-key-here
+```
+
+## Configuration
+
+### Claude Code
+
+Add to your `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "bugherd": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/bugherd-mcp/dist/index.js"],
+      "env": {
+        "BUGHERD_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "bugherd": {
+      "command": "node",
+      "args": ["/path/to/bugherd-mcp/dist/index.js"],
+      "env": {
+        "BUGHERD_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `bugherd_list_projects`
+
+List all BugHerd projects accessible to the authenticated user.
+
+**Parameters:** None
+
+**Example:**
+
+```
+List my BugHerd projects
+```
+
+### `bugherd_list_tasks`
+
+List tasks for a specific project with optional filters.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `project_id` | number | Yes | The BugHerd project ID |
+| `status` | string | No | Filter: backlog, todo, doing, done, closed |
+| `priority` | string | No | Filter: critical, important, normal, minor |
+| `tag` | string | No | Filter by tag name |
+| `page` | number | No | Page number for pagination |
+
+**Example:**
+
+```
+Show me all critical bugs in project 12345
+```
+
+### `bugherd_get_task`
+
+Get detailed information about a specific task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `project_id` | number | Yes | The BugHerd project ID |
+| `task_id` | number | Yes | The task ID |
+
+**Example:**
+
+```
+Get details for task 678 in project 12345
+```
+
+### `bugherd_list_comments`
+
+List all comments on a specific task.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `project_id` | number | Yes | The BugHerd project ID |
+| `task_id` | number | Yes | The task ID |
+
+**Example:**
+
+```
+Show comments on task 678 in project 12345
+```
+
+## Development
+
+### Run in development mode:
+
+```bash
+bun run dev
+```
+
+### Test with MCP Inspector:
+
+```bash
+BUGHERD_API_KEY=xxx bun run inspector
+```
+
+### Build for production:
+
+```bash
+bun run build
+```
+
+## API Rate Limits
+
+BugHerd allows an average of 60 requests per minute with bursts of up to 10 in quick succession. The server handles rate limiting errors gracefully.
+
+## License
+
+MIT
+
+## Author
+
+[Berckan Guerrero](https://github.com/berckan) (hi@berck.io)
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Related
+
+- [BugHerd API Documentation](https://www.bugherd.com/api_v2)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

package/dist/api/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * BugHerd API v2 Client
+ * @see https://www.bugherd.com/api_v2
+ *
+ * Authentication: Basic HTTP Auth with API key as user, 'x' as password
+ * Rate Limit: 60 requests/minute average, bursts of 10
+ */
+import type { BugherdProjectsResponse, BugherdProjectResponse, BugherdTasksResponse, BugherdTaskResponse, BugherdCommentsResponse } from "../types/bugherd.js";
+/**
+ * List all projects accessible to the authenticated user
+ */
+export declare function listProjects(): Promise<BugherdProjectsResponse>;
+/**
+ * Get a single project by ID
+ */
+export declare function getProject(projectId: number): Promise<BugherdProjectResponse>;
+export interface ListTasksOptions {
+    status?: "backlog" | "todo" | "doing" | "done" | "closed";
+    priority?: "critical" | "important" | "normal" | "minor";
+    tag?: string;
+    assignedTo?: number;
+    page?: number;
+}
+/**
+ * List tasks for a project with optional filters
+ */
+export declare function listTasks(projectId: number, options?: ListTasksOptions): Promise<BugherdTasksResponse>;
+/**
+ * Get a single task by ID
+ */
+export declare function getTask(projectId: number, taskId: number): Promise<BugherdTaskResponse>;
+/**
+ * List comments for a task
+ */
+export declare function listComments(projectId: number, taskId: number): Promise<BugherdCommentsResponse>;
+/**
+ * Verify API connection by fetching organization info
+ */
+export declare function verifyConnection(): Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAkE7B;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1D,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CAIlC;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzD"}

package/dist/api/client.js

@@ -0,0 +1,115 @@
+/**
+ * BugHerd API v2 Client
+ * @see https://www.bugherd.com/api_v2
+ *
+ * Authentication: Basic HTTP Auth with API key as user, 'x' as password
+ * Rate Limit: 60 requests/minute average, bursts of 10
+ */
+const BUGHERD_BASE_URL = "https://www.bugherd.com/api_v2";
+/**
+ * Get the API key from environment variables
+ */
+function getApiKey() {
+    const apiKey = process.env.BUGHERD_API_KEY;
+    if (!apiKey) {
+        throw new Error("BUGHERD_API_KEY environment variable is required. " +
+            "Get your API key from BugHerd Settings > General Settings.");
+    }
+    return apiKey;
+}
+/**
+ * Make an authenticated request to the BugHerd API
+ */
+async function bugherdRequest(endpoint, options = {}) {
+    const apiKey = getApiKey();
+    const auth = Buffer.from(`${apiKey}:x`).toString("base64");
+    const url = `${BUGHERD_BASE_URL}${endpoint}`;
+    const response = await fetch(url, {
+        ...options,
+        headers: {
+            Authorization: `Basic ${auth}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            ...options.headers,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 429) {
+            throw new Error("BugHerd API rate limit exceeded. Wait a moment and try again.");
+        }
+        if (response.status === 401) {
+            throw new Error("BugHerd API authentication failed. Check your BUGHERD_API_KEY.");
+        }
+        if (response.status === 404) {
+            throw new Error(`BugHerd resource not found: ${endpoint}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`BugHerd API error (${response.status}): ${errorText}`);
+    }
+    return response.json();
+}
+// ============================================================================
+// Projects
+// ============================================================================
+/**
+ * List all projects accessible to the authenticated user
+ */
+export async function listProjects() {
+    return bugherdRequest("/projects.json");
+}
+/**
+ * Get a single project by ID
+ */
+export async function getProject(projectId) {
+    return bugherdRequest(`/projects/${projectId}.json`);
+}
+/**
+ * List tasks for a project with optional filters
+ */
+export async function listTasks(projectId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status)
+        params.set("status", options.status);
+    if (options.priority)
+        params.set("priority", options.priority);
+    if (options.tag)
+        params.set("tag", options.tag);
+    if (options.assignedTo)
+        params.set("assigned_to_id", options.assignedTo.toString());
+    if (options.page)
+        params.set("page", options.page.toString());
+    const query = params.toString();
+    const endpoint = `/projects/${projectId}/tasks.json${query ? `?${query}` : ""}`;
+    return bugherdRequest(endpoint);
+}
+/**
+ * Get a single task by ID
+ */
+export async function getTask(projectId, taskId) {
+    return bugherdRequest(`/projects/${projectId}/tasks/${taskId}.json`);
+}
+// ============================================================================
+// Comments
+// ============================================================================
+/**
+ * List comments for a task
+ */
+export async function listComments(projectId, taskId) {
+    return bugherdRequest(`/projects/${projectId}/tasks/${taskId}/comments.json`);
+}
+// ============================================================================
+// Health Check
+// ============================================================================
+/**
+ * Verify API connection by fetching organization info
+ */
+export async function verifyConnection() {
+    try {
+        await listProjects();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * BugHerd MCP Server
+ *
+ * An MCP server that provides tools to interact with BugHerd's bug tracking API.
+ * Enables Claude to list projects, view tasks, and read feedback from BugHerd.
+ *
+ * @author Berckan Guerrero <hi@berck.io>
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,350 @@
+#!/usr/bin/env node
+/**
+ * BugHerd MCP Server
+ *
+ * An MCP server that provides tools to interact with BugHerd's bug tracking API.
+ * Enables Claude to list projects, view tasks, and read feedback from BugHerd.
+ *
+ * @author Berckan Guerrero <hi@berck.io>
+ * @license MIT
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod/v4";
+import { listProjects, listTasks, getTask, listComments, verifyConnection, } from "./api/client.js";
+import { getStatusName, getPriorityName } from "./types/bugherd.js";
+// ============================================================================
+// Server Setup
+// ============================================================================
+const server = new Server({
+    name: "bugherd-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ============================================================================
+// Tool Schemas (Zod)
+// ============================================================================
+const ListProjectsSchema = z.object({});
+const ListTasksSchema = z.object({
+    project_id: z.number().describe("The BugHerd project ID"),
+    status: z
+        .enum(["backlog", "todo", "doing", "done", "closed"])
+        .optional()
+        .describe("Filter by task status"),
+    priority: z
+        .enum(["critical", "important", "normal", "minor"])
+        .optional()
+        .describe("Filter by priority"),
+    tag: z.string().optional().describe("Filter by tag name"),
+    page: z.number().optional().describe("Page number for pagination"),
+});
+const GetTaskSchema = z.object({
+    project_id: z.number().describe("The BugHerd project ID"),
+    task_id: z.number().describe("The task ID to retrieve"),
+});
+const ListCommentsSchema = z.object({
+    project_id: z.number().describe("The BugHerd project ID"),
+    task_id: z.number().describe("The task ID to get comments for"),
+});
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+const TOOLS = [
+    {
+        name: "bugherd_list_projects",
+        description: "List all BugHerd projects accessible to the authenticated user. Returns project names, URLs, and IDs.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "bugherd_list_tasks",
+        description: "List tasks (bugs/feedback) for a specific BugHerd project. Can filter by status, priority, or tag.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "number",
+                    description: "The BugHerd project ID",
+                },
+                status: {
+                    type: "string",
+                    enum: ["backlog", "todo", "doing", "done", "closed"],
+                    description: "Filter by task status",
+                },
+                priority: {
+                    type: "string",
+                    enum: ["critical", "important", "normal", "minor"],
+                    description: "Filter by priority",
+                },
+                tag: {
+                    type: "string",
+                    description: "Filter by tag name",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number for pagination (default: 1)",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "bugherd_get_task",
+        description: "Get detailed information about a specific task including description, screenshot URL, selector info, and metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "number",
+                    description: "The BugHerd project ID",
+                },
+                task_id: {
+                    type: "number",
+                    description: "The task ID to retrieve",
+                },
+            },
+            required: ["project_id", "task_id"],
+        },
+    },
+    {
+        name: "bugherd_list_comments",
+        description: "List all comments on a specific task. Returns comment text, author, and timestamp.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "number",
+                    description: "The BugHerd project ID",
+                },
+                task_id: {
+                    type: "number",
+                    description: "The task ID to get comments for",
+                },
+            },
+            required: ["project_id", "task_id"],
+        },
+    },
+];
+// ============================================================================
+// Request Handlers
+// ============================================================================
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // Verify connection on first call
+        const connected = await verifyConnection();
+        if (!connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Unable to connect to BugHerd API. Check your BUGHERD_API_KEY environment variable.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        switch (name) {
+            // ====================================================================
+            // bugherd_list_projects
+            // ====================================================================
+            case "bugherd_list_projects": {
+                const result = await listProjects();
+                const projects = result.projects;
+                if (projects.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "No projects found. Make sure your API key has access to at least one project.",
+                            },
+                        ],
+                    };
+                }
+                const projectList = projects
+                    .map((p) => `- **${p.name}** (ID: ${p.id})\n  URL: ${p.devurl}\n  Active: ${p.is_active ? "Yes" : "No"}`)
+                    .join("\n\n");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `## BugHerd Projects (${projects.length})\n\n${projectList}`,
+                        },
+                    ],
+                };
+            }
+            // ====================================================================
+            // bugherd_list_tasks
+            // ====================================================================
+            case "bugherd_list_tasks": {
+                const parsed = ListTasksSchema.parse(args);
+                const options = {
+                    status: parsed.status,
+                    priority: parsed.priority,
+                    tag: parsed.tag,
+                    page: parsed.page,
+                };
+                const result = await listTasks(parsed.project_id, options);
+                const tasks = result.tasks;
+                const meta = result.meta;
+                if (tasks.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "No tasks found matching the criteria.",
+                            },
+                        ],
+                    };
+                }
+                const taskList = tasks
+                    .map((t) => {
+                    const status = getStatusName(t.status_id);
+                    const priority = getPriorityName(t.priority_id);
+                    const tags = t.tag_names.length > 0 ? t.tag_names.join(", ") : "none";
+                    const description = t.description.length > 100
+                        ? t.description.substring(0, 100) + "..."
+                        : t.description;
+                    return `### Task #${t.local_task_id} (ID: ${t.id})
+- **Status:** ${status}
+- **Priority:** ${priority}
+- **Tags:** ${tags}
+- **Created:** ${t.created_at}
+- **Description:** ${description}
+- [View in BugHerd](${t.admin_link})`;
+                })
+                    .join("\n\n");
+                const pagination = `Page ${meta.current_page} of ${meta.total_pages} (${meta.count} total tasks)`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `## Tasks for Project ${parsed.project_id}\n\n${pagination}\n\n${taskList}`,
+                        },
+                    ],
+                };
+            }
+            // ====================================================================
+            // bugherd_get_task
+            // ====================================================================
+            case "bugherd_get_task": {
+                const parsed = GetTaskSchema.parse(args);
+                const result = await getTask(parsed.project_id, parsed.task_id);
+                const task = result.task;
+                const status = getStatusName(task.status_id);
+                const priority = getPriorityName(task.priority_id);
+                const tags = task.tag_names.length > 0 ? task.tag_names.join(", ") : "none";
+                let selectorInfo = "Not available";
+                if (task.selector_info) {
+                    selectorInfo = `URL: ${task.selector_info.url}\nSelector: \`${task.selector_info.selector}\``;
+                }
+                const output = `## Task #${task.local_task_id}
+
+**Status:** ${status}
+**Priority:** ${priority}
+**Tags:** ${tags}
+**Created:** ${task.created_at}
+**Updated:** ${task.updated_at}
+**Requester:** ${task.requester_email}
+**Assigned To:** ${task.assigned_to_id ?? "Unassigned"}
+
+### Description
+${task.description}
+
+### Screenshot
+${task.screenshot ?? "No screenshot available"}
+
+### Element Info
+${selectorInfo}
+
+### Links
+- [View in BugHerd](${task.admin_link})`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: output,
+                        },
+                    ],
+                };
+            }
+            // ====================================================================
+            // bugherd_list_comments
+            // ====================================================================
+            case "bugherd_list_comments": {
+                const parsed = ListCommentsSchema.parse(args);
+                const result = await listComments(parsed.project_id, parsed.task_id);
+                const comments = result.comments;
+                if (comments.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "No comments on this task.",
+                            },
+                        ],
+                    };
+                }
+                const commentList = comments
+                    .map((c) => `**${c.user.display_name}** (${c.created_at}):\n> ${c.text}`)
+                    .join("\n\n---\n\n");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `## Comments on Task ${parsed.task_id} (${comments.length})\n\n${commentList}`,
+                        },
+                    ],
+                };
+            }
+            // ====================================================================
+            // Unknown Tool
+            // ====================================================================
+            default:
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unknown tool: ${name}`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ============================================================================
+// Start Server
+// ============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("BugHerd MCP Server started");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    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/types/bugherd.d.ts

@@ -0,0 +1,79 @@
+/**
+ * BugHerd API v2 TypeScript Types
+ * @see https://www.bugherd.com/api_v2
+ */
+export interface BugherdUser {
+    id: number;
+    email: string;
+    display_name: string;
+    avatar_url: string | null;
+}
+export interface BugherdProject {
+    id: number;
+    name: string;
+    devurl: string;
+    is_active: boolean;
+    is_public: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface BugherdProjectsResponse {
+    projects: BugherdProject[];
+}
+export interface BugherdProjectResponse {
+    project: BugherdProject;
+}
+export type BugherdTaskStatus = "backlog" | "todo" | "doing" | "done" | "closed";
+export type BugherdTaskPriority = "not set" | "critical" | "important" | "normal" | "minor";
+export interface BugherdTask {
+    id: number;
+    local_task_id: number;
+    priority_id: number | null;
+    status_id: number;
+    description: string;
+    created_at: string;
+    updated_at: string;
+    external_id: string | null;
+    requester_id: number;
+    requester_email: string;
+    assigned_to_id: number | null;
+    tag_names: string[];
+    admin_link: string;
+    screenshot: string | null;
+    selector_info: {
+        selector: string;
+        url: string;
+    } | null;
+    status?: BugherdTaskStatus;
+    priority?: BugherdTaskPriority;
+}
+export interface BugherdTasksResponse {
+    tasks: BugherdTask[];
+    meta: {
+        count: number;
+        total_pages: number;
+        current_page: number;
+    };
+}
+export interface BugherdTaskResponse {
+    task: BugherdTask;
+}
+export interface BugherdComment {
+    id: number;
+    user_id: number;
+    text: string;
+    created_at: string;
+    user: BugherdUser;
+}
+export interface BugherdCommentsResponse {
+    comments: BugherdComment[];
+}
+export interface BugherdApiError {
+    error: string;
+    message?: string;
+}
+export declare const STATUS_MAP: Record<number, BugherdTaskStatus>;
+export declare const PRIORITY_MAP: Record<number, BugherdTaskPriority>;
+export declare function getStatusName(statusId: number): BugherdTaskStatus;
+export declare function getPriorityName(priorityId: number | null): BugherdTaskPriority;
+//# sourceMappingURL=bugherd.d.ts.map

package/dist/types/bugherd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugherd.d.ts","sourceRoot":"","sources":["../../src/types/bugherd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAMD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,CAAC;CACzB;AAMD,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IAET,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;CACnB;AAMD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAMxD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAM5D,CAAC;AAEF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAEjE;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,mBAAmB,CAGrB"}

package/dist/types/bugherd.js

@@ -0,0 +1,30 @@
+/**
+ * BugHerd API v2 TypeScript Types
+ * @see https://www.bugherd.com/api_v2
+ */
+// ============================================================================
+// Status and Priority Mappings
+// ============================================================================
+export const STATUS_MAP = {
+    0: "backlog",
+    1: "todo",
+    2: "doing",
+    3: "done",
+    4: "closed",
+};
+export const PRIORITY_MAP = {
+    0: "not set",
+    1: "critical",
+    2: "important",
+    3: "normal",
+    4: "minor",
+};
+export function getStatusName(statusId) {
+    return STATUS_MAP[statusId] ?? "backlog";
+}
+export function getPriorityName(priorityId) {
+    if (priorityId === null)
+        return "not set";
+    return PRIORITY_MAP[priorityId] ?? "not set";
+}
+//# sourceMappingURL=bugherd.js.map

package/dist/types/bugherd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugherd.js","sourceRoot":"","sources":["../../src/types/bugherd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmHH,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAsC;IAC3D,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAwC;IAC/D,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;CACX,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAyB;IAEzB,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "bugherd-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for BugHerd integration - manage bugs and feedback from Claude",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bugherd-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "bun run src/index.ts",
+    "start": "node dist/index.js",
+    "inspector": "npx @modelcontextprotocol/inspector bun run src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "bugherd",
+    "claude",
+    "bug-tracking",
+    "feedback"
+  ],
+  "author": "Berckan Guerrero <hi@berck.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/berckan/bugherd-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.5",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Berckan/bugherd-mcp",
+  "description": "BugHerd bug tracking integration. List projects, tasks, comments with filtering.",
+  "repository": {
+    "url": "https://github.com/Berckan/bugherd-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "bugherd-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "description": "BugHerd API key from Settings > General Settings",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true,
+          "name": "BUGHERD_API_KEY"
+        }
+      ]
+    }
+  ]
+}