@dobbyai/mcp-external 1.0.4 → 1.1.0

package/dist/tools/github-mcp.js

@@ -0,0 +1,397 @@
+/**
+ * GitHub MCP Integration Tools
+ *
+ * Phase 1, Task 1.1: Connect GitHub MCP Server to Dobby.
+ * Provides tools for code management, PR automation, and CI/CD monitoring
+ * through the official GitHub MCP Server (ghcr.io/github/github-mcp-server).
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const githubMcpTools = {
+    github_search_code: {
+        name: 'github_search_code',
+        annotations: {
+            title: 'GitHub Search Code',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Search for code across GitHub repositories using the GitHub MCP Server. Returns matching files and code snippets.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g., "authentication middleware", "BigQuery parameterized query")',
+                },
+                repo: {
+                    type: 'string',
+                    description: 'Optional: Limit search to a specific repo (e.g., "gil-dobby/repo-dobby")',
+                },
+                language: {
+                    type: 'string',
+                    description: 'Optional: Filter by language (e.g., "typescript", "python")',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    github_get_file: {
+        name: 'github_get_file',
+        annotations: {
+            title: 'GitHub Get File',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Read a file from a GitHub repository. Returns file content.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo" (e.g., "gil-dobby/repo-dobby")',
+                },
+                path: {
+                    type: 'string',
+                    description: 'File path within the repo (e.g., "web/shared/lib/gateway/auth.ts")',
+                },
+                branch: {
+                    type: 'string',
+                    description: 'Optional: Branch name (default: main)',
+                },
+            },
+            required: ['repo', 'path'],
+        },
+    },
+    github_create_pr: {
+        name: 'github_create_pr',
+        annotations: {
+            title: 'GitHub Create PR',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Create a Pull Request on GitHub. Requires an existing branch with commits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                title: {
+                    type: 'string',
+                    description: 'PR title',
+                },
+                body: {
+                    type: 'string',
+                    description: 'PR description in markdown',
+                },
+                head: {
+                    type: 'string',
+                    description: 'Source branch name',
+                },
+                base: {
+                    type: 'string',
+                    description: 'Target branch (default: main)',
+                },
+            },
+            required: ['repo', 'title', 'head'],
+        },
+    },
+    github_list_prs: {
+        name: 'github_list_prs',
+        annotations: {
+            title: 'GitHub List PRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List Pull Requests for a repository with optional filters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                state: {
+                    type: 'string',
+                    enum: ['open', 'closed', 'all'],
+                    description: 'Filter by PR state (default: open)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of PRs to return (default: 10)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+    github_list_issues: {
+        name: 'github_list_issues',
+        annotations: {
+            title: 'GitHub List Issues',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List issues for a repository with optional filters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                state: {
+                    type: 'string',
+                    enum: ['open', 'closed', 'all'],
+                    description: 'Filter by issue state (default: open)',
+                },
+                labels: {
+                    type: 'string',
+                    description: 'Comma-separated label names to filter by',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of issues to return (default: 10)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+    github_create_issue: {
+        name: 'github_create_issue',
+        annotations: {
+            title: 'GitHub Create Issue',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Create a new issue on a GitHub repository.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Issue title',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Issue body in markdown',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Labels to add',
+                },
+            },
+            required: ['repo', 'title'],
+        },
+    },
+    github_get_workflow_runs: {
+        name: 'github_get_workflow_runs',
+        annotations: {
+            title: 'GitHub Workflow Runs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List recent GitHub Actions workflow runs for CI/CD monitoring.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository in format "owner/repo"',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['completed', 'in_progress', 'queued', 'failure', 'success'],
+                    description: 'Filter by run status',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of runs to return (default: 5)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+};
+// ============================================
+// GitHub API Helper
+// ============================================
+const GITHUB_API = 'https://api.github.com';
+async function githubFetch(endpoint, options = {}) {
+    const token = process.env.GITHUB_TOKEN || process.env.GITHUB_PERSONAL_ACCESS_TOKEN;
+    if (!token) {
+        throw new Error('GITHUB_TOKEN not configured. Set it in .env or environment variables.');
+    }
+    const response = await fetch(`${GITHUB_API}${endpoint}`, {
+        ...options,
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            ...options.headers,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`GitHub API error (${response.status}): ${body.slice(0, 200)}`);
+    }
+    return response.json();
+}
+// ============================================
+// Tool Handlers
+// ============================================
+export async function handleGithubSearchCode(_client, args) {
+    let q = args.query;
+    if (args.repo)
+        q += ` repo:${args.repo}`;
+    if (args.language)
+        q += ` language:${args.language}`;
+    const data = await githubFetch(`/search/code?q=${encodeURIComponent(q)}&per_page=10`);
+    const items = (data.items || []).map((item) => ({
+        name: item.name,
+        path: item.path,
+        repo: item.repository?.full_name,
+        url: item.html_url,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ total: data.total_count, results: items }, null, 2),
+            }],
+    };
+}
+export async function handleGithubGetFile(_client, args) {
+    const ref = args.branch ? `?ref=${args.branch}` : '';
+    const data = await githubFetch(`/repos/${args.repo}/contents/${args.path}${ref}`);
+    let content = data.content;
+    if (data.encoding === 'base64') {
+        content = Buffer.from(data.content, 'base64').toString('utf-8');
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: content,
+            }],
+    };
+}
+export async function handleGithubCreatePr(_client, args) {
+    const data = await githubFetch(`/repos/${args.repo}/pulls`, {
+        method: 'POST',
+        body: JSON.stringify({
+            title: args.title,
+            body: args.body || '',
+            head: args.head,
+            base: args.base || 'main',
+        }),
+    });
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    pr_number: data.number,
+                    url: data.html_url,
+                    state: data.state,
+                    title: data.title,
+                }, null, 2),
+            }],
+    };
+}
+export async function handleGithubListPrs(_client, args) {
+    const state = args.state || 'open';
+    const limit = args.limit || 10;
+    const data = await githubFetch(`/repos/${args.repo}/pulls?state=${state}&per_page=${limit}`);
+    const prs = data.map((pr) => ({
+        number: pr.number,
+        title: pr.title,
+        state: pr.state,
+        author: pr.user?.login,
+        url: pr.html_url,
+        created_at: pr.created_at,
+        updated_at: pr.updated_at,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(prs, null, 2),
+            }],
+    };
+}
+export async function handleGithubListIssues(_client, args) {
+    const state = args.state || 'open';
+    const limit = args.limit || 10;
+    let url = `/repos/${args.repo}/issues?state=${state}&per_page=${limit}`;
+    if (args.labels)
+        url += `&labels=${encodeURIComponent(args.labels)}`;
+    const data = await githubFetch(url);
+    const issues = data.filter((i) => !i.pull_request).map((i) => ({
+        number: i.number,
+        title: i.title,
+        state: i.state,
+        labels: i.labels?.map((l) => l.name),
+        assignee: i.assignee?.login,
+        url: i.html_url,
+        created_at: i.created_at,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(issues, null, 2),
+            }],
+    };
+}
+export async function handleGithubCreateIssue(_client, args) {
+    const data = await githubFetch(`/repos/${args.repo}/issues`, {
+        method: 'POST',
+        body: JSON.stringify({
+            title: args.title,
+            body: args.body || '',
+            labels: args.labels || [],
+        }),
+    });
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    issue_number: data.number,
+                    url: data.html_url,
+                    state: data.state,
+                }, null, 2),
+            }],
+    };
+}
+export async function handleGithubGetWorkflowRuns(_client, args) {
+    const limit = args.limit || 5;
+    let url = `/repos/${args.repo}/actions/runs?per_page=${limit}`;
+    if (args.status)
+        url += `&status=${args.status}`;
+    const data = await githubFetch(url);
+    const runs = (data.workflow_runs || []).map((r) => ({
+        id: r.id,
+        name: r.name,
+        status: r.status,
+        conclusion: r.conclusion,
+        branch: r.head_branch,
+        url: r.html_url,
+        created_at: r.created_at,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(runs, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=github-mcp.js.map

package/dist/tools/github-mcp.js.map

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

package/dist/tools/governance.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Governance MCP Tools
+ *
+ * Policy-as-Code operations via MCP for Claude Desktop/Cursor/VS Code users.
+ * 4 tools:
+ *   1. export_policies       — Export org governance policies as YAML/JSON
+ *   2. import_policies       — Import policies from YAML/JSON
+ *   3. validate_policies     — Dry-run validate a policy document
+ *   4. apply_guardrail       — Apply a guardrail template to an org
+ */
+import { DobbyClient } from '../lib/dobby-client.js';
+export declare const governanceTools: {
+    export_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                format: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    import_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    validate_policies: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    apply_guardrail: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                template: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+export declare function handleExportPolicies(args: {
+    organization_id: string;
+    format?: string;
+}, client: DobbyClient): Promise<string>;
+export declare function handleImportPolicies(args: {
+    organization_id: string;
+    content: string;
+}, client: DobbyClient): Promise<string>;
+export declare function handleValidatePolicies(args: {
+    organization_id: string;
+    content: string;
+}, client: DobbyClient): Promise<string>;
+export declare function handleApplyGuardrail(args: {
+    organization_id: string;
+    template: string;
+}, client: DobbyClient): Promise<string>;
+//# sourceMappingURL=governance.d.ts.map

package/dist/tools/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/tools/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G3B,CAAC;AAMF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAClD,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAClD,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACnD,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAYjB"}