@ldraney/github-mcp 0.1.0 → 0.2.0-beta.0

package/dist/index.js

@@ -2,6 +2,7 @@
 import { Command } from 'commander';
 import { getToken, login, logout, getAuthStatus } from './auth/oauth-flow.js';
 import { startServer } from './server.js';
+import { ToolGenerator } from './tools/generator.js';
 const program = new Command();
 program
     .name('github-mcp')
@@ -9,7 +10,8 @@ program
     .version('0.1.0');
 // Default command: start server
 program
-    .action(async () => {
+    .option('-c, --categories <categories>', `Comma-separated list of tool categories to load (available: ${ToolGenerator.getAvailableCategories().join(', ')})`)
+    .action(async (options) => {
     try {
         let token = await getToken();
         if (!token) {
@@ -20,7 +22,11 @@ program
             console.error('Authentication failed. Cannot start server.');
             process.exit(1);
         }
-        await startServer(token);
+        // Parse categories if provided
+        const categories = options.categories
+            ? options.categories.split(',').map((c) => c.trim())
+            : undefined;
+        await startServer(token, { categories });
     }
     catch (error) {
         console.error('Error:', error instanceof Error ? error.message : error);

package/dist/prompts/activity-summary.d.ts

@@ -0,0 +1,10 @@
+import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Activity summary prompt definitions
+ */
+export declare const activityPrompts: Prompt[];
+/**
+ * Generate a prompt result for activity summaries
+ * These prompts instruct Claude to use the activity tools to fetch and summarize events
+ */
+export declare function getActivityPrompt(name: string, args: Record<string, string>): GetPromptResult;

package/dist/prompts/activity-summary.js

@@ -0,0 +1,154 @@
+/**
+ * Activity summary prompt definitions
+ */
+export const activityPrompts = [
+    {
+        name: 'daily_summary',
+        description: 'Summarize GitHub activity from the last 24 hours for a repository',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'weekly_summary',
+        description: 'Summarize GitHub activity from the last 7 days for a repository',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'repo_activity',
+        description: 'Get recent activity summary for a repository (configurable timeframe)',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'days',
+                description: 'Number of days to look back (default: 7)',
+                required: false,
+            },
+        ],
+    },
+];
+/**
+ * Generate a prompt result for activity summaries
+ * These prompts instruct Claude to use the activity tools to fetch and summarize events
+ */
+export function getActivityPrompt(name, args) {
+    const owner = args.owner;
+    const repo = args.repo;
+    switch (name) {
+        case 'daily_summary':
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please summarize the GitHub activity for ${owner}/${repo} from the last 24 hours.
+
+Use the github_activity_list_repo_events tool to fetch recent events for this repository, then provide a summary that includes:
+
+1. **Commits**: Any push events with commit messages
+2. **Pull Requests**: Opened, closed, or merged PRs
+3. **Issues**: New issues or issue comments
+4. **Reviews**: PR reviews and review comments
+5. **Releases**: Any new releases or tags
+
+Filter the events to only include those from the last 24 hours based on the created_at timestamp.
+
+If there's no activity, say so clearly.`,
+                        },
+                    },
+                ],
+            };
+        case 'weekly_summary':
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please summarize the GitHub activity for ${owner}/${repo} from the last 7 days.
+
+Use the github_activity_list_repo_events tool to fetch recent events for this repository (you may need to paginate through results), then provide a comprehensive summary that includes:
+
+1. **Commits**: Push events with notable commit messages grouped by author
+2. **Pull Requests**: Opened, closed, or merged PRs with titles
+3. **Issues**: New issues, closed issues, and notable issue discussions
+4. **Reviews**: PR reviews and their outcomes
+5. **Releases**: Any new releases with version numbers
+6. **Contributors**: Active contributors during this period
+
+Filter the events to only include those from the last 7 days based on the created_at timestamp.
+
+Organize the summary by category and highlight the most significant changes.`,
+                        },
+                    },
+                ],
+            };
+        case 'repo_activity':
+            const days = parseInt(args.days) || 7;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please summarize the GitHub activity for ${owner}/${repo} from the last ${days} day(s).
+
+Use the github_activity_list_repo_events tool to fetch recent events for this repository, then provide a summary that includes:
+
+1. **Overview**: Quick stats on total events by type
+2. **Commits**: Notable push events and commit activity
+3. **Pull Requests**: PR activity (opened, closed, merged)
+4. **Issues**: Issue activity (opened, closed, commented)
+5. **Other Events**: Any other notable activity (releases, forks, stars, etc.)
+
+Filter the events to only include those from the last ${days} day(s) based on the created_at timestamp.
+
+Present the information in a clear, scannable format.`,
+                        },
+                    },
+                ],
+            };
+        default:
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Unknown prompt: ${name}`,
+                        },
+                    },
+                ],
+            };
+    }
+}

package/dist/server.d.ts

@@ -1,4 +1,11 @@
+/**
+ * Server startup options
+ */
+export interface ServerOptions {
+    /** Categories to load (default: all) */
+    categories?: string[];
+}
 /**
  * Start the MCP server with authenticated Octokit
  */
-export declare function startServer(token: string): Promise<void>;
+export declare function startServer(token: string, options?: ServerOptions): Promise<void>;

package/dist/server.js

@@ -1,11 +1,13 @@
 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 { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { Octokit } from '@octokit/rest';
+import { createToolGenerator } from './tools/generator.js';
+import { activityPrompts, getActivityPrompt } from './prompts/activity-summary.js';
 /**
  * Start the MCP server with authenticated Octokit
  */
-export async function startServer(token) {
+export async function startServer(token, options = {}) {
     const octokit = new Octokit({ auth: token });
     // Verify token works
     try {
@@ -15,230 +17,38 @@ export async function startServer(token) {
     catch (error) {
         throw new Error('Failed to authenticate with GitHub. Token may be invalid.');
     }
+    // Initialize tool generator with specified categories
+    const generator = createToolGenerator(options.categories);
     const server = new Server({
         name: 'github-mcp',
         version: '0.1.0',
     }, {
         capabilities: {
             tools: {},
+            prompts: {},
         },
     });
     // 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: {},
-                    },
-                },
-            ],
+            tools: generator.getTools(),
         };
     });
     // 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,
-            };
-        }
+        return generator.executeTool(octokit, name, args ?? {});
+    });
+    // List available prompts
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return {
+            prompts: activityPrompts,
+        };
+    });
+    // Handle prompt requests
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return getActivityPrompt(name, args ?? {});
     });
     // Connect via stdio
     const transport = new StdioServerTransport();

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

@@ -1,5 +1,2 @@
-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
+import type { ToolCategory } from '../types.js';
+export declare const actionsCategory: ToolCategory;