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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,9 @@
1
+ import type { Prompt, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
2
+ /**
3
+ * Help prompt definitions
4
+ */
5
+ export declare const helpPrompts: Prompt[];
6
+ /**
7
+ * Generate a help prompt result
8
+ */
9
+ export declare function getHelpPrompt(name: string, _args: Record<string, string>): GetPromptResult | null;
@@ -0,0 +1,86 @@
1
+ /**
2
+ * Help prompt definitions
3
+ */
4
+ export const helpPrompts = [
5
+ {
6
+ name: 'github_help',
7
+ description: 'Get help using the GitHub MCP server - shows available capabilities and example queries',
8
+ arguments: [],
9
+ },
10
+ ];
11
+ /**
12
+ * Generate a help prompt result
13
+ */
14
+ export function getHelpPrompt(name, _args) {
15
+ if (name !== 'github_help') {
16
+ return null;
17
+ }
18
+ return {
19
+ messages: [
20
+ {
21
+ role: 'user',
22
+ content: {
23
+ type: 'text',
24
+ text: `Please explain what the GitHub MCP server can do and give me examples of how to use it.
25
+
26
+ The GitHub MCP server provides 327 tools across these categories:
27
+
28
+ ## Repository Management
29
+ - List, create, update, delete repositories
30
+ - Browse branches, commits, and file contents
31
+ - Compare commits and manage collaborators
32
+ - **Try:** "Show my 5 most recently updated repos" or "List branches on owner/repo"
33
+
34
+ ## Issues & Pull Requests
35
+ - List, create, update, close issues and PRs
36
+ - Add comments, labels, and assignees
37
+ - Review PRs and manage merge status
38
+ - **Try:** "Show open issues on owner/repo" or "Get details of PR #123"
39
+
40
+ ## Search
41
+ - Search repos, code, issues, users, commits
42
+ - **Try:** "Search for repos about 'machine learning' with 1000+ stars"
43
+
44
+ ## Actions & CI/CD
45
+ - List workflows, runs, jobs
46
+ - View logs, artifacts, secrets
47
+ - Cancel or re-run workflows
48
+ - **Try:** "Show recent workflow runs for owner/repo"
49
+
50
+ ## Organizations & Teams
51
+ - Manage org members, teams, permissions
52
+ - **Try:** "List members of my-org"
53
+
54
+ ## Activity & Notifications
55
+ - View repo events, stars, watchers
56
+ - Check notifications
57
+ - **Try:** "Show recent activity on owner/repo"
58
+
59
+ ## Security
60
+ - Dependabot alerts, code scanning, secret scanning
61
+ - Security advisories
62
+ - **Try:** "List Dependabot alerts for owner/repo"
63
+
64
+ ## And More...
65
+ - Gists, packages, projects, reactions
66
+ - Git data (blobs, trees, refs, tags)
67
+ - Rate limits, licenses, emojis
68
+
69
+ ## Pre-built Prompts
70
+ You can also use these prompts for common workflows:
71
+ - \`code_review\` - Review a PR with detailed feedback
72
+ - \`issue_triage\` - Analyze and categorize issues
73
+ - \`release_notes\` - Generate release notes between versions
74
+ - \`daily_summary\` / \`weekly_summary\` - Activity summaries
75
+
76
+ ## Tips
77
+ 1. Be specific: "List open issues labeled 'bug' on owner/repo"
78
+ 2. Use filters: "Show my repos sorted by stars"
79
+ 3. Chain actions: "Find the PR that fixed issue #42 and summarize it"
80
+
81
+ What would you like to do?`,
82
+ },
83
+ },
84
+ ],
85
+ };
86
+ }
package/dist/server.js CHANGED
@@ -7,8 +7,10 @@ import { activityPrompts, getActivityPrompt } from './prompts/activity-summary.j
7
7
  import { codeReviewPrompts, getCodeReviewPrompt } from './prompts/code-review.js';
8
8
  import { issueTriagePrompts, getIssueTriagePrompt } from './prompts/issue-triage.js';
9
9
  import { releaseNotesPrompts, getReleaseNotesPrompt } from './prompts/release-notes.js';
10
+ import { helpPrompts, getHelpPrompt } from './prompts/help.js';
10
11
  // Combine all prompts
11
12
  const allPrompts = [
13
+ ...helpPrompts,
12
14
  ...activityPrompts,
13
15
  ...codeReviewPrompts,
14
16
  ...issueTriagePrompts,
@@ -60,7 +62,8 @@ export async function startServer(token, options = {}) {
60
62
  const { name, arguments: args } = request.params;
61
63
  const promptArgs = args ?? {};
62
64
  // Try each prompt handler
63
- const result = getCodeReviewPrompt(name, promptArgs) ??
65
+ const result = getHelpPrompt(name, promptArgs) ??
66
+ getCodeReviewPrompt(name, promptArgs) ??
64
67
  getIssueTriagePrompt(name, promptArgs) ??
65
68
  getReleaseNotesPrompt(name, promptArgs) ??
66
69
  getActivityPrompt(name, promptArgs);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ldraney/github-mcp",
3
- "version": "0.2.0-beta.2",
3
+ "version": "0.2.0-beta.3",
4
4
  "description": "GitHub MCP server with OAuth and 800+ API endpoints",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",