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

package/dist/prompts/code-review.d.ts

@@ -0,0 +1,9 @@
+import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Code review prompt definitions
+ */
+export declare const codeReviewPrompts: Prompt[];
+/**
+ * Generate a prompt result for code review
+ */
+export declare function getCodeReviewPrompt(name: string, args: Record<string, string>): GetPromptResult | null;

package/dist/prompts/code-review.js

@@ -0,0 +1,145 @@
+/**
+ * Code review prompt definitions
+ */
+export const codeReviewPrompts = [
+    {
+        name: 'code_review',
+        description: 'Review a pull request with detailed suggestions and feedback',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'pull_number',
+                description: 'Pull request number',
+                required: true,
+            },
+            {
+                name: 'focus',
+                description: 'Review focus area (e.g., security, performance, style, all)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'pr_summary',
+        description: 'Generate a concise summary of a pull request',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'pull_number',
+                description: 'Pull request number',
+                required: true,
+            },
+        ],
+    },
+];
+/**
+ * Generate a prompt result for code review
+ */
+export function getCodeReviewPrompt(name, args) {
+    const owner = args.owner;
+    const repo = args.repo;
+    const pullNumber = args.pull_number;
+    switch (name) {
+        case 'code_review':
+            const focus = args.focus || 'all';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please review pull request #${pullNumber} in ${owner}/${repo}.
+
+First, use these tools to gather information:
+1. github_pulls_get - Get PR details (title, description, state)
+2. github_pulls_list_files - Get the list of changed files
+3. github_pulls_list_commits - Get commits in this PR
+
+Then provide a comprehensive code review with focus on: ${focus === 'all' ? 'all aspects' : focus}
+
+Structure your review as follows:
+
+## Summary
+Brief overview of what this PR does.
+
+## Changes Analysis
+List the files changed with a brief description of each change.
+
+## Review Feedback
+
+${focus === 'all' || focus === 'security' ? `### Security
+- Check for potential vulnerabilities (injection, XSS, auth issues, etc.)
+- Review sensitive data handling
+- Check for hardcoded credentials or secrets
+` : ''}
+${focus === 'all' || focus === 'performance' ? `### Performance
+- Identify potential bottlenecks
+- Check for inefficient algorithms or queries
+- Review resource usage
+` : ''}
+${focus === 'all' || focus === 'style' ? `### Code Style & Quality
+- Check naming conventions
+- Review code organization
+- Suggest readability improvements
+` : ''}
+### Logic & Correctness
+- Verify the implementation matches the PR description
+- Check edge cases
+- Identify potential bugs
+
+## Suggestions
+Specific, actionable suggestions for improvement.
+
+## Verdict
+Overall assessment: Approve, Request Changes, or Comment.`,
+                        },
+                    },
+                ],
+            };
+        case 'pr_summary':
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please provide a concise summary of pull request #${pullNumber} in ${owner}/${repo}.
+
+Use these tools:
+1. github_pulls_get - Get PR details
+2. github_pulls_list_files - Get changed files
+3. github_pulls_list_commits - Get commits
+
+Provide a summary that includes:
+- **Title & Purpose**: What does this PR do?
+- **Files Changed**: List of files with change type (added/modified/deleted)
+- **Key Changes**: Bullet points of the main changes
+- **Size**: Lines added/removed, number of files
+
+Keep it brief - this is for quick understanding, not a full review.`,
+                        },
+                    },
+                ],
+            };
+        default:
+            return null;
+    }
+}

package/dist/prompts/issue-triage.d.ts

@@ -0,0 +1,9 @@
+import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Issue triage prompt definitions
+ */
+export declare const issueTriagePrompts: Prompt[];
+/**
+ * Generate a prompt result for issue triage
+ */
+export declare function getIssueTriagePrompt(name: string, args: Record<string, string>): GetPromptResult | null;

package/dist/prompts/issue-triage.js

@@ -0,0 +1,202 @@
+/**
+ * Issue triage prompt definitions
+ */
+export const issueTriagePrompts = [
+    {
+        name: 'issue_triage',
+        description: 'Analyze and categorize a GitHub issue with suggested labels and priority',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'issue_number',
+                description: 'Issue number to triage',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'issue_batch_triage',
+        description: 'Triage multiple open issues and suggest prioritization',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'limit',
+                description: 'Number of issues to triage (default: 10)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'find_duplicates',
+        description: 'Find potential duplicate issues in a repository',
+        arguments: [
+            {
+                name: 'owner',
+                description: 'Repository owner (username or organization)',
+                required: true,
+            },
+            {
+                name: 'repo',
+                description: 'Repository name',
+                required: true,
+            },
+            {
+                name: 'issue_number',
+                description: 'Issue number to find duplicates for',
+                required: true,
+            },
+        ],
+    },
+];
+/**
+ * Generate a prompt result for issue triage
+ */
+export function getIssueTriagePrompt(name, args) {
+    const owner = args.owner;
+    const repo = args.repo;
+    switch (name) {
+        case 'issue_triage':
+            const issueNumber = args.issue_number;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please triage issue #${issueNumber} in ${owner}/${repo}.
+
+Use these tools:
+1. github_issues_get - Get issue details
+2. github_issues_list_comments - Get any discussion
+3. github_issues_list_labels - Get available labels in the repo
+
+Provide a triage report:
+
+## Issue Summary
+Brief description of what the issue is about.
+
+## Classification
+- **Type**: Bug, Feature Request, Documentation, Question, or Other
+- **Severity**: Critical, High, Medium, or Low
+- **Effort Estimate**: Small, Medium, Large, or Unknown
+
+## Suggested Labels
+Based on available labels in the repo, suggest which labels to apply.
+
+## Priority Assessment
+Explain why this issue should be prioritized at a certain level.
+
+## Additional Context
+- Is more information needed from the reporter?
+- Are there related issues that should be linked?
+- Who might be a good assignee based on the problem area?
+
+## Recommended Next Steps
+What should happen next with this issue?`,
+                        },
+                    },
+                ],
+            };
+        case 'issue_batch_triage':
+            const limit = parseInt(args.limit) || 10;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please triage the open issues in ${owner}/${repo}.
+
+Use these tools:
+1. github_issues_list - Get open issues (limit: ${limit}, state: open)
+2. github_issues_list_labels - Get available labels
+
+For each issue, provide a brief triage:
+
+## Issues Overview
+
+Create a table with:
+| # | Title | Type | Severity | Effort | Suggested Labels |
+|---|-------|------|----------|--------|------------------|
+
+## Priority Ranking
+List the issues in recommended priority order with brief justification.
+
+## Quick Wins
+Identify any issues that are low effort but high value.
+
+## Needs Attention
+Flag any issues that:
+- Are stale and need follow-up
+- Need more information
+- Might be duplicates
+
+## Recommended Actions
+Suggest immediate actions to improve issue hygiene.`,
+                        },
+                    },
+                ],
+            };
+        case 'find_duplicates':
+            const targetIssue = args.issue_number;
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please find potential duplicate issues for #${targetIssue} in ${owner}/${repo}.
+
+Use these tools:
+1. github_issues_get - Get the target issue details
+2. github_issues_list - Get other open issues to compare
+3. github_search_issues_and_pull_requests - Search for similar issues by keywords
+
+Process:
+1. Read issue #${targetIssue} to understand what it's about
+2. Extract key terms and concepts
+3. Search for issues with similar terms
+4. Compare and identify potential duplicates
+
+Report format:
+
+## Target Issue
+Brief summary of #${targetIssue}
+
+## Potential Duplicates
+For each potential duplicate:
+- **Issue #X**: Title
+  - Similarity: High/Medium/Low
+  - Reason: Why it might be a duplicate
+  - Key differences: What's different
+
+## Recommendation
+- Which issues (if any) should be marked as duplicates
+- Which issue should be kept as the primary
+- Any issues that are related but not duplicates`,
+                        },
+                    },
+                ],
+            };
+        default:
+            return null;
+    }
+}

package/dist/prompts/release-notes.d.ts

@@ -0,0 +1,9 @@
+import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Release notes prompt definitions
+ */
+export declare const releaseNotesPrompts: Prompt[];
+/**
+ * Generate a prompt result for release notes
+ */
+export declare function getReleaseNotesPrompt(name: string, args: Record<string, string>): GetPromptResult | null;

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.js

@@ -4,6 +4,16 @@ import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema
 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
  */
@@ -42,13 +52,19 @@ export async function startServer(token, options = {}) {
     // List available prompts
     server.setRequestHandler(ListPromptsRequestSchema, async () => {
         return {
-            prompts: activityPrompts,
+            prompts: allPrompts,
         };
     });
     // Handle prompt requests
     server.setRequestHandler(GetPromptRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
-        return getActivityPrompt(name, args ?? {});
+        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/packages.js

@@ -330,7 +330,7 @@ export const packagesCategory = {
         // get_all_package_versions_for_package_owned_by_authenticated_user
         {
             definition: {
-                name: 'github_packages_get_all_package_versions_for_package_owned_by_authenticated_user',
+                name: 'github_packages_list_versions_for_auth_user',
                 description: 'Get all package versions for a package owned by the authenticated user',
                 inputSchema: {
                     type: 'object',
@@ -375,7 +375,7 @@ export const packagesCategory = {
         // get_all_package_versions_for_package_owned_by_user
         {
             definition: {
-                name: 'github_packages_get_all_package_versions_for_package_owned_by_user',
+                name: 'github_packages_list_versions_for_user',
                 description: 'Get all package versions for a package owned by a user',
                 inputSchema: {
                     type: 'object',
@@ -419,7 +419,7 @@ export const packagesCategory = {
         // get_all_package_versions_for_package_owned_by_org
         {
             definition: {
-                name: 'github_packages_get_all_package_versions_for_package_owned_by_org',
+                name: 'github_packages_list_versions_for_org',
                 description: 'Get all package versions for a package owned by an organization',
                 inputSchema: {
                     type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldraney/github-mcp",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.2",
   "description": "GitHub MCP server with OAuth and 800+ API endpoints",
   "type": "module",
   "main": "dist/index.js",