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

package/dist/prompts/release-notes.js

@@ -0,0 +1,236 @@
+/**
+ * Release notes prompt definitions
+ */
+export const releaseNotesPrompts = [
+    {
+        name: 'release_notes',
+        description: 'Generate release notes from commits between two refs',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'base',
+                description: 'Base ref (tag, branch, or SHA) - e.g., v1.0.0',
+                required: true,
+            },
+            {
+                name: 'head',
+                description: 'Head ref (tag, branch, or SHA) - e.g., v1.1.0 or main',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'changelog',
+        description: 'Generate a changelog from recent commits',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'since',
+                description: 'Number of days to look back (default: 30)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'whats_new',
+        description: 'Generate a user-friendly "What\'s New" summary for a release',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'base',
+                description: 'Previous release tag - e.g., v1.0.0',
+                required: true,
+            },
+            {
+                name: 'head',
+                description: 'New release tag - e.g., v1.1.0',
+                required: true,
+            },
+        ],
+    },
+];
+/**
+ * Generate a prompt result for release notes
+ */
+export function getReleaseNotesPrompt(name, args) {
+    const owner = args.owner;
+    const repo = args.repo;
+    switch (name) {
+        case 'release_notes':
+            const base = args.base;
+            const head = args.head;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please generate release notes for ${owner}/${repo} comparing ${base} to ${head}.
+
+Use these tools:
+1. github_repos_compare_commits - Compare the two refs to get all commits
+2. github_pulls_list - Get merged PRs (state: closed) to find associated PRs
+3. github_issues_list - Get closed issues that might be referenced
+
+Generate release notes in this format:
+
+# Release Notes: ${head}
+
+## Overview
+Brief summary of this release (2-3 sentences).
+
+## Breaking Changes
+List any breaking changes that require user action.
+
+## New Features
+- Feature descriptions from commits/PRs with conventional commit type "feat"
+
+## Bug Fixes
+- Bug fixes from commits/PRs with conventional commit type "fix"
+
+## Improvements
+- Enhancements, refactors, and other improvements
+
+## Documentation
+- Documentation updates
+
+## Dependencies
+- Dependency updates
+
+## Contributors
+List of contributors to this release.
+
+---
+
+**Full Changelog**: ${base}...${head}
+
+Parse conventional commit messages where available (feat:, fix:, docs:, chore:, etc.).
+Group commits logically and write clear, user-friendly descriptions.`,
+                        },
+                    },
+                ],
+            };
+        case 'changelog':
+            const days = parseInt(args.since) || 30;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please generate a changelog for ${owner}/${repo} from the last ${days} days.
+
+Use these tools:
+1. github_repos_list_commits - Get recent commits
+2. github_pulls_list - Get recently merged PRs (state: closed)
+
+Generate a changelog:
+
+# Changelog
+
+## [Unreleased]
+
+### Added
+- New features (feat: commits)
+
+### Changed
+- Changes to existing functionality
+
+### Deprecated
+- Features that will be removed
+
+### Removed
+- Removed features
+
+### Fixed
+- Bug fixes (fix: commits)
+
+### Security
+- Security-related changes
+
+---
+
+Group commits by type based on conventional commit prefixes.
+Include PR numbers and links where applicable.
+Only include commits from the last ${days} days.`,
+                        },
+                    },
+                ],
+            };
+        case 'whats_new':
+            const prevRelease = args.base;
+            const newRelease = args.head;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please generate a user-friendly "What's New" summary for ${owner}/${repo} release ${newRelease}.
+
+Use these tools:
+1. github_repos_compare_commits - Compare ${prevRelease} to ${newRelease}
+2. github_pulls_list - Get merged PRs for context
+
+Generate a "What's New" post suitable for users (not developers):
+
+# What's New in ${newRelease}
+
+## Highlights
+Top 3-5 most impactful changes in plain language.
+
+## New Features
+User-facing features explained simply:
+- **Feature Name**: What it does and why it's useful
+
+## Improvements
+Quality of life improvements:
+- What got better and how it helps users
+
+## Bug Fixes
+Notable fixes that affected users:
+- What was broken and that it's now fixed
+
+## Getting Started
+How to update and try the new features.
+
+---
+
+Write in a friendly, accessible tone.
+Focus on user benefits, not technical implementation.
+Avoid jargon and commit message details.`,
+                        },
+                    },
+                ],
+            };
+        default:
+            return null;
+    }
+}

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,23 @@
 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';
+import { codeReviewPrompts, getCodeReviewPrompt } from './prompts/code-review.js';
+import { issueTriagePrompts, getIssueTriagePrompt } from './prompts/issue-triage.js';
+import { releaseNotesPrompts, getReleaseNotesPrompt } from './prompts/release-notes.js';
+// Combine all prompts
+const allPrompts = [
+    ...activityPrompts,
+    ...codeReviewPrompts,
+    ...issueTriagePrompts,
+    ...releaseNotesPrompts,
+];
 /**
  * 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 +27,44 @@ 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: allPrompts,
+        };
+    });
+    // Handle prompt requests
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const promptArgs = args ?? {};
+        // Try each prompt handler
+        const result = getCodeReviewPrompt(name, promptArgs) ??
+            getIssueTriagePrompt(name, promptArgs) ??
+            getReleaseNotesPrompt(name, promptArgs) ??
+            getActivityPrompt(name, promptArgs);
+        return result;
     });
     // 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;