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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ldraney
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -45,7 +45,20 @@ Add to your Claude Desktop config:
   "mcpServers": {
     "github": {
       "command": "npx",
-      "args": ["github-mcp"]
+      "args": ["@ldraney/github-mcp", "--preset", "core"]
+    }
+  }
+}
+```
+
+For security-focused work:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["@ldraney/github-mcp", "--preset", "security"]
     }
   }
 }
@@ -66,6 +79,30 @@ github-mcp auth status   # Check auth status
 GITHUB_TOKEN=ghp_xxx github-mcp
 ```
 
+### Presets
+
+Claude Desktop has a ~100 tool limit. Use presets to load only what you need:
+
+```bash
+github-mcp --preset core        # Daily dev work (~95 tools)
+github-mcp --preset security    # Security audits (~50 tools)
+github-mcp --preset org-admin   # Org management (~70 tools)
+github-mcp --preset cicd        # CI/CD automation (~60 tools)
+github-mcp --preset full        # All 327 tools (Claude Code only)
+```
+
+| Preset | Categories | Use Case |
+|--------|-----------|----------|
+| `core` (default) | repos, issues, pulls, search, users, actions, gists | Daily development |
+| `security` | dependabot, secretScanning, codeScanning, codeSecurity, securityAdvisories | Security audits |
+| `org-admin` | orgs, teams, projects, activity, users, apps | Organization management |
+| `cicd` | actions, checks, repos, packages | CI/CD pipelines |
+| `full` | all 32 categories | Claude Code with tool search |
+
+List presets: `github-mcp --list-presets`
+
+Override with custom categories: `github-mcp --categories repos,issues,pulls`
+
 ## Available Tools
 
 Tools are organized by GitHub API category:
@@ -126,6 +163,11 @@ npm run build
 npm start
 ```
 
+## Contact
+
+- [LinkedIn](https://www.linkedin.com/in/lucas-draney-904457133/)
+- [GitHub Issues](https://github.com/ldraney/github-mcp/issues)
+
 ## License
 
 MIT

package/dist/auth/token-storage.js

@@ -1,4 +1,4 @@
-import keytar from 'keytar';
+import { Entry } from '@napi-rs/keyring';
 const SERVICE_NAME = 'github-mcp';
 const ACCOUNT_NAME = 'oauth-token';
 const SCOPE_ACCOUNT = 'oauth-scopes';
@@ -6,28 +6,54 @@ const SCOPE_ACCOUNT = 'oauth-scopes';
  * Store token securely in OS keychain
  */
 export async function storeToken(token, scopes) {
-    await keytar.setPassword(SERVICE_NAME, ACCOUNT_NAME, token);
+    const tokenEntry = new Entry(SERVICE_NAME, ACCOUNT_NAME);
+    tokenEntry.setPassword(token);
     if (scopes) {
-        await keytar.setPassword(SERVICE_NAME, SCOPE_ACCOUNT, scopes);
+        const scopeEntry = new Entry(SERVICE_NAME, SCOPE_ACCOUNT);
+        scopeEntry.setPassword(scopes);
     }
 }
 /**
  * Retrieve token from OS keychain
  */
 export async function retrieveToken() {
-    return keytar.getPassword(SERVICE_NAME, ACCOUNT_NAME);
+    try {
+        const entry = new Entry(SERVICE_NAME, ACCOUNT_NAME);
+        return entry.getPassword();
+    }
+    catch {
+        return null;
+    }
 }
 /**
  * Retrieve stored scopes
  */
 export async function retrieveScopes() {
-    return keytar.getPassword(SERVICE_NAME, SCOPE_ACCOUNT);
+    try {
+        const entry = new Entry(SERVICE_NAME, SCOPE_ACCOUNT);
+        return entry.getPassword();
+    }
+    catch {
+        return null;
+    }
 }
 /**
  * Delete token from OS keychain
  */
 export async function deleteToken() {
-    const tokenDeleted = await keytar.deletePassword(SERVICE_NAME, ACCOUNT_NAME);
-    await keytar.deletePassword(SERVICE_NAME, SCOPE_ACCOUNT);
-    return tokenDeleted;
+    try {
+        const tokenEntry = new Entry(SERVICE_NAME, ACCOUNT_NAME);
+        tokenEntry.deletePassword();
+    }
+    catch {
+        // Token didn't exist
+    }
+    try {
+        const scopeEntry = new Entry(SERVICE_NAME, SCOPE_ACCOUNT);
+        scopeEntry.deletePassword();
+    }
+    catch {
+        // Scopes didn't exist
+    }
+    return true;
 }

package/dist/index.js

@@ -2,7 +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';
+import { ToolGenerator, PRESETS, DEFAULT_PRESET } from './tools/generator.js';
 const program = new Command();
 program
     .name('github-mcp')
@@ -10,8 +10,19 @@ program
     .version('0.1.0');
 // Default command: start server
 program
-    .option('-c, --categories <categories>', `Comma-separated list of tool categories to load (available: ${ToolGenerator.getAvailableCategories().join(', ')})`)
+    .option('-p, --preset <preset>', `Tool preset to load (${Object.keys(PRESETS).join(', ')})`, DEFAULT_PRESET)
+    .option('-c, --categories <categories>', `Comma-separated list of tool categories (overrides preset)`)
+    .option('--list-presets', 'Show available presets and exit')
     .action(async (options) => {
+    // Handle --list-presets
+    if (options.listPresets) {
+        console.log('Available presets:\n');
+        console.log(ToolGenerator.getPresetDescriptions());
+        console.log('\nUsage: npx @ldraney/github-mcp --preset <preset>');
+        console.log('\nFor Claude Desktop, use "core" (default) to stay under 100 tools.');
+        console.log('For Claude Code, use "full" for all 327 tools.');
+        process.exit(0);
+    }
     try {
         let token = await getToken();
         if (!token) {
@@ -22,10 +33,22 @@ program
             console.error('Authentication failed. Cannot start server.');
             process.exit(1);
         }
-        // Parse categories if provided
-        const categories = options.categories
-            ? options.categories.split(',').map((c) => c.trim())
-            : undefined;
+        // Determine categories: explicit categories override preset
+        let categories;
+        if (options.categories) {
+            categories = options.categories.split(',').map((c) => c.trim());
+            console.error(`Using custom categories: ${categories.join(', ')}`);
+        }
+        else {
+            const preset = options.preset || DEFAULT_PRESET;
+            categories = ToolGenerator.getPresetCategories(preset);
+            if (!categories) {
+                console.error(`Unknown preset: ${preset}`);
+                console.error(`Available presets: ${ToolGenerator.getAvailablePresets().join(', ')}`);
+                process.exit(1);
+            }
+            console.error(`Using preset: ${preset}`);
+        }
         await startServer(token, { categories });
     }
     catch (error) {

package/dist/tools/generator.d.ts

@@ -1,5 +1,17 @@
 import type { Octokit } from '@octokit/rest';
 import type { MCPToolDefinition, ToolResult } from './types.js';
+/**
+ * Preset configurations for different use cases
+ * Each preset stays under ~100 tools for Claude Desktop compatibility
+ */
+export declare const PRESETS: Record<string, {
+    description: string;
+    categories: string[];
+}>;
+/**
+ * Default preset for Claude Desktop compatibility
+ */
+export declare const DEFAULT_PRESET = "core";
 /**
  * Tool generator that manages tool loading and execution
  */
@@ -27,6 +39,18 @@ export declare class ToolGenerator {
      * Get list of available category names
      */
     static getAvailableCategories(): string[];
+    /**
+     * Get list of available preset names
+     */
+    static getAvailablePresets(): string[];
+    /**
+     * Get categories for a preset
+     */
+    static getPresetCategories(preset: string): string[] | undefined;
+    /**
+     * Get preset descriptions for help text
+     */
+    static getPresetDescriptions(): string;
     /**
      * Get count of loaded tools
      */

package/dist/tools/generator.js

@@ -39,16 +39,46 @@ const ALL_CATEGORIES = {
     codesOfConduct: codesOfConductCategory,
 };
 /**
- * Default categories to load if none specified
+ * Preset configurations for different use cases
+ * Each preset stays under ~100 tools for Claude Desktop compatibility
  */
-const DEFAULT_CATEGORIES = [
-    'repos', 'issues', 'pulls', 'users', 'actions', 'search', 'orgs',
-    'gists', 'checks', 'projects', 'teams', 'activity', 'git',
-    'reactions', 'packages', 'dependabot', 'secretScanning', 'codeScanning',
-    'codeSecurity', 'securityAdvisories', 'apps', 'billing', 'codespaces',
-    'copilot', 'migrations', 'interactions', 'rateLimit', 'markdown',
-    'meta', 'emojis', 'gitignore', 'licenses', 'codesOfConduct',
-];
+export const PRESETS = {
+    core: {
+        description: 'Essential tools for daily development (~95 tools)',
+        categories: ['repos', 'issues', 'pulls', 'search', 'users', 'actions', 'gists'],
+    },
+    security: {
+        description: 'Security scanning and vulnerability management (~50 tools)',
+        categories: ['dependabot', 'secretScanning', 'codeScanning', 'codeSecurity', 'securityAdvisories'],
+    },
+    'org-admin': {
+        description: 'Organization and team management (~70 tools)',
+        categories: ['orgs', 'teams', 'projects', 'activity', 'users', 'apps'],
+    },
+    cicd: {
+        description: 'CI/CD and automation tools (~60 tools)',
+        categories: ['actions', 'checks', 'repos', 'packages'],
+    },
+    full: {
+        description: 'All 327 tools - recommended for Claude Code only',
+        categories: [
+            'repos', 'issues', 'pulls', 'users', 'actions', 'search', 'orgs',
+            'gists', 'checks', 'projects', 'teams', 'activity', 'git',
+            'reactions', 'packages', 'dependabot', 'secretScanning', 'codeScanning',
+            'codeSecurity', 'securityAdvisories', 'apps', 'billing', 'codespaces',
+            'copilot', 'migrations', 'interactions', 'rateLimit', 'markdown',
+            'meta', 'emojis', 'gitignore', 'licenses', 'codesOfConduct',
+        ],
+    },
+};
+/**
+ * Default preset for Claude Desktop compatibility
+ */
+export const DEFAULT_PRESET = 'core';
+/**
+ * Default categories to load if none specified (uses core preset)
+ */
+const DEFAULT_CATEGORIES = PRESETS[DEFAULT_PRESET].categories;
 /**
  * Tool generator that manages tool loading and execution
  */
@@ -107,6 +137,26 @@ export class ToolGenerator {
     static getAvailableCategories() {
         return Object.keys(ALL_CATEGORIES);
     }
+    /**
+     * Get list of available preset names
+     */
+    static getAvailablePresets() {
+        return Object.keys(PRESETS);
+    }
+    /**
+     * Get categories for a preset
+     */
+    static getPresetCategories(preset) {
+        return PRESETS[preset]?.categories;
+    }
+    /**
+     * Get preset descriptions for help text
+     */
+    static getPresetDescriptions() {
+        return Object.entries(PRESETS)
+            .map(([name, config]) => `  ${name}: ${config.description}`)
+            .join('\n');
+    }
     /**
      * Get count of loaded tools
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldraney/github-mcp",
-  "version": "0.2.0-beta.3",
+  "version": "0.2.3",
   "description": "GitHub MCP server with OAuth and 800+ API endpoints",
   "type": "module",
   "main": "dist/index.js",
@@ -39,7 +39,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@octokit/rest": "^21.0.0",
     "commander": "^12.1.0",
-    "keytar": "^7.9.0",
+    "@napi-rs/keyring": "^1.2.0",
     "open": "^10.1.0"
   },
   "devDependencies": {