@ldraney/github-mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { getToken, login, logout, getAuthStatus } from './auth/oauth-flow.js';
+import { startServer } from './server.js';
+const program = new Command();
+program
+    .name('github-mcp')
+    .description('GitHub MCP server with OAuth authentication')
+    .version('0.1.0');
+// Default command: start server
+program
+    .action(async () => {
+    try {
+        let token = await getToken();
+        if (!token) {
+            console.log('No token found. Starting authentication flow...');
+            token = await login();
+        }
+        if (!token) {
+            console.error('Authentication failed. Cannot start server.');
+            process.exit(1);
+        }
+        await startServer(token);
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+// Auth subcommands
+const authCommand = program
+    .command('auth')
+    .description('Manage GitHub authentication');
+authCommand
+    .command('login')
+    .description('Authenticate with GitHub')
+    .action(async () => {
+    try {
+        const token = await login();
+        if (token) {
+            console.log('Successfully authenticated!');
+        }
+        else {
+            console.error('Authentication failed.');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+authCommand
+    .command('logout')
+    .description('Remove stored authentication')
+    .action(async () => {
+    try {
+        await logout();
+        console.log('Logged out successfully.');
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+authCommand
+    .command('status')
+    .description('Check authentication status')
+    .action(async () => {
+    try {
+        const status = await getAuthStatus();
+        if (status.authenticated) {
+            console.log(`Authenticated as: ${status.username}`);
+            console.log(`Scopes: ${status.scopes?.join(', ') || 'unknown'}`);
+        }
+        else {
+            console.log('Not authenticated.');
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE3E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,qEAAqE,CAAC;KAClF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACrC,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;KACxD,MAAM,CAAC,qBAAqB,EAAE,mDAAmD,CAAC;KAClF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yBAAyB,CAAC;KACtC,UAAU,CACT,IAAI,OAAO,CAAC,OAAO,CAAC;KACjB,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,KAAK,EAAE,CAAC;AAChB,CAAC,CAAC,CACL;KACA,UAAU,CACT,IAAI,OAAO,CAAC,QAAQ,CAAC;KAClB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,MAAM,EAAE,CAAC;AACjB,CAAC,CAAC,CACL;KACA,UAAU,CACT,IAAI,OAAO,CAAC,QAAQ,CAAC;KAClB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC,CAAC,CACL,CAAC;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/resources/webhooks.d.ts

@@ -0,0 +1,15 @@
+import { Resource } from '@modelcontextprotocol/sdk/types.js';
+export interface WebhookResourceContents {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+/**
+ * Get all webhook-related resources
+ */
+export declare function getWebhookResources(): Resource[];
+/**
+ * Read a webhook resource
+ */
+export declare function readWebhookResource(uri: string): WebhookResourceContents;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/resources/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAG9D,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,EAAE,CA4ChD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAiExE"}

package/dist/resources/webhooks.js

@@ -0,0 +1,194 @@
+import { eventQueue } from '../webhooks/event-queue.js';
+import { getSmeeUrl } from '../webhooks/smee-client.js';
+/**
+ * Get all webhook-related resources
+ */
+export function getWebhookResources() {
+    const resources = [];
+    // Status resource
+    resources.push({
+        uri: 'github://webhooks/status',
+        name: 'Webhook Status',
+        description: 'Current webhook listener status and event counts',
+        mimeType: 'application/json',
+    });
+    // All events resource
+    resources.push({
+        uri: 'github://webhooks/all',
+        name: 'All Events',
+        description: 'All recent webhook events',
+        mimeType: 'application/json',
+    });
+    // Per-type resources for active types
+    const activeTypes = eventQueue.getEventTypes();
+    for (const type of activeTypes) {
+        resources.push({
+            uri: `github://webhooks/events/${type}`,
+            name: `${formatEventType(type)} Events`,
+            description: `Recent ${type} webhook events`,
+            mimeType: 'application/json',
+        });
+    }
+    // Common types (even if not yet received)
+    const commonTypes = ['push', 'pull_request', 'issues', 'issue_comment', 'release', 'workflow_run', 'check_run'];
+    for (const type of commonTypes) {
+        if (!activeTypes.includes(type)) {
+            resources.push({
+                uri: `github://webhooks/events/${type}`,
+                name: `${formatEventType(type)} Events`,
+                description: `Recent ${type} webhook events (waiting for events)`,
+                mimeType: 'application/json',
+            });
+        }
+    }
+    return resources;
+}
+/**
+ * Read a webhook resource
+ */
+export function readWebhookResource(uri) {
+    // Status resource
+    if (uri === 'github://webhooks/status') {
+        const status = {
+            connected: getSmeeUrl() !== null,
+            smeeUrl: getSmeeUrl(),
+            eventCounts: eventQueue.getCounts(),
+            totalEvents: eventQueue.getAll().length,
+            activeEventTypes: eventQueue.getEventTypes(),
+        };
+        return {
+            uri,
+            mimeType: 'application/json',
+            text: JSON.stringify(status, null, 2),
+        };
+    }
+    // All events resource
+    if (uri === 'github://webhooks/all') {
+        const events = eventQueue.getAll(100);
+        return {
+            uri,
+            mimeType: 'application/json',
+            text: JSON.stringify(formatEvents(events), null, 2),
+        };
+    }
+    // Type-specific resource
+    const typeMatch = uri.match(/^github:\/\/webhooks\/events\/(.+)$/);
+    if (typeMatch) {
+        const type = typeMatch[1];
+        const events = eventQueue.getByType(type, 100);
+        return {
+            uri,
+            mimeType: 'application/json',
+            text: JSON.stringify(formatEvents(events), null, 2),
+        };
+    }
+    // Legacy format support
+    const legacyMatch = uri.match(/^github:\/\/webhooks\/(.+)$/);
+    if (legacyMatch && legacyMatch[1] !== 'status') {
+        const type = legacyMatch[1];
+        if (type === 'all') {
+            const events = eventQueue.getAll(100);
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(formatEvents(events), null, 2),
+            };
+        }
+        const events = eventQueue.getByType(type, 100);
+        return {
+            uri,
+            mimeType: 'application/json',
+            text: JSON.stringify(formatEvents(events), null, 2),
+        };
+    }
+    return {
+        uri,
+        mimeType: 'application/json',
+        text: JSON.stringify({ error: 'Unknown resource' }),
+    };
+}
+/**
+ * Format events for output
+ */
+function formatEvents(events) {
+    return {
+        count: events.length,
+        events: events.map(event => ({
+            id: event.id,
+            type: event.type,
+            action: event.action,
+            receivedAt: event.receivedAt.toISOString(),
+            repository: event.repository?.full_name,
+            sender: event.sender?.login,
+            summary: getEventSummary(event),
+        })),
+    };
+}
+/**
+ * Get a human-readable summary of an event
+ */
+function getEventSummary(event) {
+    const { type, action, payload, sender, repository } = event;
+    const by = sender?.login ? ` by ${sender.login}` : '';
+    const repo = repository?.full_name ? ` in ${repository.full_name}` : '';
+    switch (type) {
+        case 'push': {
+            const commits = payload.commits?.length || 0;
+            const ref = payload.ref?.replace('refs/heads/', '') || 'unknown';
+            return `${commits} commit(s) pushed to ${ref}${by}${repo}`;
+        }
+        case 'pull_request': {
+            const prNumber = payload.number || '?';
+            const prTitle = payload.pull_request?.title || '';
+            return `PR #${prNumber} ${action}${by}: ${prTitle}`;
+        }
+        case 'issues': {
+            const issueNumber = payload.issue?.number || '?';
+            const issueTitle = payload.issue?.title || '';
+            return `Issue #${issueNumber} ${action}${by}: ${issueTitle}`;
+        }
+        case 'issue_comment': {
+            const issueNumber = payload.issue?.number || '?';
+            return `Comment ${action} on issue #${issueNumber}${by}`;
+        }
+        case 'release': {
+            const tagName = payload.release?.tag_name || '?';
+            return `Release ${tagName} ${action}${by}${repo}`;
+        }
+        case 'workflow_run': {
+            const workflowName = payload.workflow_run?.name || 'workflow';
+            const conclusion = payload.workflow_run?.conclusion || action;
+            return `${workflowName} ${conclusion}${repo}`;
+        }
+        case 'check_run': {
+            const checkName = payload.check_run?.name || 'check';
+            const conclusion = payload.check_run?.conclusion || action;
+            return `${checkName} ${conclusion}${repo}`;
+        }
+        case 'create':
+        case 'delete': {
+            const refType = payload.ref_type || 'ref';
+            const ref = payload.ref || '?';
+            return `${refType} ${ref} ${type}d${by}${repo}`;
+        }
+        case 'fork': {
+            const forkee = payload.forkee?.full_name || '?';
+            return `Forked to ${forkee}${by}`;
+        }
+        case 'star': {
+            return `Repository ${action}red${by}`;
+        }
+        default:
+            return `${type}${action ? ` (${action})` : ''}${by}${repo}`;
+    }
+}
+/**
+ * Format event type for display
+ */
+function formatEventType(type) {
+    return type
+        .split('_')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/resources/webhooks.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Start the MCP server with authenticated Octokit
+ */
+export declare function startServer(token: string): Promise<void>;

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyH5E"}

package/dist/server.js

@@ -0,0 +1,247 @@
+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 { Octokit } from '@octokit/rest';
+/**
+ * Start the MCP server with authenticated Octokit
+ */
+export async function startServer(token) {
+    const octokit = new Octokit({ auth: token });
+    // Verify token works
+    try {
+        const { data: user } = await octokit.users.getAuthenticated();
+        console.error(`Authenticated as ${user.login}`);
+    }
+    catch (error) {
+        throw new Error('Failed to authenticate with GitHub. Token may be invalid.');
+    }
+    const server = new Server({
+        name: 'github-mcp',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'github_repos_list',
+                    description: 'List repositories for the authenticated user',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            visibility: {
+                                type: 'string',
+                                enum: ['all', 'public', 'private'],
+                                description: 'Filter by visibility',
+                            },
+                            sort: {
+                                type: 'string',
+                                enum: ['created', 'updated', 'pushed', 'full_name'],
+                                description: 'Sort field',
+                            },
+                            per_page: {
+                                type: 'number',
+                                description: 'Results per page (max 100)',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'github_repos_get',
+                    description: 'Get a repository by owner and name',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            owner: {
+                                type: 'string',
+                                description: 'Repository owner',
+                            },
+                            repo: {
+                                type: 'string',
+                                description: 'Repository name',
+                            },
+                        },
+                        required: ['owner', 'repo'],
+                    },
+                },
+                {
+                    name: 'github_issues_list',
+                    description: 'List issues for a repository',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            owner: {
+                                type: 'string',
+                                description: 'Repository owner',
+                            },
+                            repo: {
+                                type: 'string',
+                                description: 'Repository name',
+                            },
+                            state: {
+                                type: 'string',
+                                enum: ['open', 'closed', 'all'],
+                                description: 'Issue state filter',
+                            },
+                            per_page: {
+                                type: 'number',
+                                description: 'Results per page (max 100)',
+                            },
+                        },
+                        required: ['owner', 'repo'],
+                    },
+                },
+                {
+                    name: 'github_issues_create',
+                    description: 'Create a new issue',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            owner: {
+                                type: 'string',
+                                description: 'Repository owner',
+                            },
+                            repo: {
+                                type: 'string',
+                                description: 'Repository name',
+                            },
+                            title: {
+                                type: 'string',
+                                description: 'Issue title',
+                            },
+                            body: {
+                                type: 'string',
+                                description: 'Issue body',
+                            },
+                            labels: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Labels to add',
+                            },
+                        },
+                        required: ['owner', 'repo', 'title'],
+                    },
+                },
+                {
+                    name: 'github_pulls_list',
+                    description: 'List pull requests for a repository',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            owner: {
+                                type: 'string',
+                                description: 'Repository owner',
+                            },
+                            repo: {
+                                type: 'string',
+                                description: 'Repository name',
+                            },
+                            state: {
+                                type: 'string',
+                                enum: ['open', 'closed', 'all'],
+                                description: 'PR state filter',
+                            },
+                            per_page: {
+                                type: 'number',
+                                description: 'Results per page (max 100)',
+                            },
+                        },
+                        required: ['owner', 'repo'],
+                    },
+                },
+                {
+                    name: 'github_user_get',
+                    description: 'Get the authenticated user',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+            ],
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'github_repos_list': {
+                    const { data } = await octokit.repos.listForAuthenticatedUser({
+                        visibility: args?.visibility,
+                        sort: args?.sort,
+                        per_page: args?.per_page,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                case 'github_repos_get': {
+                    const { data } = await octokit.repos.get({
+                        owner: args?.owner,
+                        repo: args?.repo,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                case 'github_issues_list': {
+                    const { data } = await octokit.issues.listForRepo({
+                        owner: args?.owner,
+                        repo: args?.repo,
+                        state: args?.state,
+                        per_page: args?.per_page,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                case 'github_issues_create': {
+                    const { data } = await octokit.issues.create({
+                        owner: args?.owner,
+                        repo: args?.repo,
+                        title: args?.title,
+                        body: args?.body,
+                        labels: args?.labels,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                case 'github_pulls_list': {
+                    const { data } = await octokit.pulls.list({
+                        owner: args?.owner,
+                        repo: args?.repo,
+                        state: args?.state,
+                        per_page: args?.per_page,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                case 'github_user_get': {
+                    const { data } = await octokit.users.getAuthenticated();
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MCP server started');
+}

package/dist/server.js.map

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

package/dist/tools/categories/actions.d.ts

@@ -0,0 +1,5 @@
+import { Octokit } from '@octokit/rest';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const actionsTools: Tool[];
+export declare function handleActionsTool(octokit: Octokit, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/tools/categories/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/tools/categories/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,eAAO,MAAM,YAAY,EAAE,IAAI,EAgS9B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA2HlB"}