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

package/dist/prompts/help.d.ts

@@ -0,0 +1,9 @@
+import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Help prompt definitions
+ */
+export declare const helpPrompts: Prompt[];
+/**
+ * Generate a help prompt result
+ */
+export declare function getHelpPrompt(name: string, _args: Record<string, string>): GetPromptResult | null;

package/dist/prompts/help.js

@@ -0,0 +1,86 @@
+/**
+ * Help prompt definitions
+ */
+export const helpPrompts = [
+    {
+        name: 'github_help',
+        description: 'Get help using the GitHub MCP server - shows available capabilities and example queries',
+        arguments: [],
+    },
+];
+/**
+ * Generate a help prompt result
+ */
+export function getHelpPrompt(name, _args) {
+    if (name !== 'github_help') {
+        return null;
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Please explain what the GitHub MCP server can do and give me examples of how to use it.
+
+The GitHub MCP server provides 327 tools across these categories:
+
+## Repository Management
+- List, create, update, delete repositories
+- Browse branches, commits, and file contents
+- Compare commits and manage collaborators
+- **Try:** "Show my 5 most recently updated repos" or "List branches on owner/repo"
+
+## Issues & Pull Requests
+- List, create, update, close issues and PRs
+- Add comments, labels, and assignees
+- Review PRs and manage merge status
+- **Try:** "Show open issues on owner/repo" or "Get details of PR #123"
+
+## Search
+- Search repos, code, issues, users, commits
+- **Try:** "Search for repos about 'machine learning' with 1000+ stars"
+
+## Actions & CI/CD
+- List workflows, runs, jobs
+- View logs, artifacts, secrets
+- Cancel or re-run workflows
+- **Try:** "Show recent workflow runs for owner/repo"
+
+## Organizations & Teams
+- Manage org members, teams, permissions
+- **Try:** "List members of my-org"
+
+## Activity & Notifications
+- View repo events, stars, watchers
+- Check notifications
+- **Try:** "Show recent activity on owner/repo"
+
+## Security
+- Dependabot alerts, code scanning, secret scanning
+- Security advisories
+- **Try:** "List Dependabot alerts for owner/repo"
+
+## And More...
+- Gists, packages, projects, reactions
+- Git data (blobs, trees, refs, tags)
+- Rate limits, licenses, emojis
+
+## Pre-built Prompts
+You can also use these prompts for common workflows:
+- \`code_review\` - Review a PR with detailed feedback
+- \`issue_triage\` - Analyze and categorize issues
+- \`release_notes\` - Generate release notes between versions
+- \`daily_summary\` / \`weekly_summary\` - Activity summaries
+
+## Tips
+1. Be specific: "List open issues labeled 'bug' on owner/repo"
+2. Use filters: "Show my repos sorted by stars"
+3. Chain actions: "Find the PR that fixed issue #42 and summarize it"
+
+What would you like to do?`,
+                },
+            },
+        ],
+    };
+}

package/dist/server.js

@@ -7,8 +7,10 @@ import { activityPrompts, getActivityPrompt } from './prompts/activity-summary.j
 import { codeReviewPrompts, getCodeReviewPrompt } from './prompts/code-review.js';
 import { issueTriagePrompts, getIssueTriagePrompt } from './prompts/issue-triage.js';
 import { releaseNotesPrompts, getReleaseNotesPrompt } from './prompts/release-notes.js';
+import { helpPrompts, getHelpPrompt } from './prompts/help.js';
 // Combine all prompts
 const allPrompts = [
+    ...helpPrompts,
     ...activityPrompts,
     ...codeReviewPrompts,
     ...issueTriagePrompts,
@@ -60,7 +62,8 @@ export async function startServer(token, options = {}) {
         const { name, arguments: args } = request.params;
         const promptArgs = args ?? {};
         // Try each prompt handler
-        const result = getCodeReviewPrompt(name, promptArgs) ??
+        const result = getHelpPrompt(name, promptArgs) ??
+            getCodeReviewPrompt(name, promptArgs) ??
             getIssueTriagePrompt(name, promptArgs) ??
             getReleaseNotesPrompt(name, promptArgs) ??
             getActivityPrompt(name, promptArgs);

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.1",
+  "version": "0.2.0-beta.3",
   "description": "GitHub MCP server with OAuth and 800+ API endpoints",
   "type": "module",
   "main": "dist/index.js",