Github Mcp

#!/usr/bin/env node
'use strict';

/**
 * github-mcp - Post-Execute Hook
 * Records execution result and logs completion of GitHub MCP operations.
 */

const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// ─── Result parsing ────────────────────────────────────────────────────────────

function parseResult() {
  const raw = process.argv.length > 2 ? process.argv.slice(2).join(' ') : '{}';
  try {
    return safeParseJSON(raw) || {};
  } catch (_err) {
    return {};
  }
}

// ─── Result assessment ─────────────────────────────────────────────────────────

function assessResult(result) {
  const warnings = [];
  const payload = result && typeof result === 'object' ? result : {};

  // Warn if the operation reported errors
  if (payload.error) {
    warnings.push(`GitHub MCP reported an error: ${payload.error}`);
  }

  // Warn if authentication issues detected
  if (payload.authError || payload.statusCode === 401 || payload.statusCode === 403) {
    warnings.push('GitHub authentication issue detected; verify GITHUB_PERSONAL_ACCESS_TOKEN');
  }

  // Warn if rate-limited
  if (payload.statusCode === 429 || payload.rateLimited) {
    warnings.push('GitHub API rate limit reached; consider waiting before retrying');
  }

  return warnings;
}

// ─── Main ──────────────────────────────────────────────────────────────────────

const result = parseResult();
const warnings = assessResult(result);

console.log('[GITHUB-MCP] Post-execute processing...');

if (warnings.length > 0) {
  for (const w of warnings) {
    console.warn(`[GITHUB-MCP] Warning: ${w}`);
  }
}

console.log('[GITHUB-MCP] Post-processing complete');
process.exit(0);

#!/usr/bin/env node
'use strict';

/**
 * github-mcp - Pre-Execute Hook
 * Validates prerequisites before the GitHub MCP skill executes.
 *
 * Checks:
 *   1. GITHUB_PERSONAL_ACCESS_TOKEN environment variable is set
 *   2. Input context is valid JSON (if provided)
 */

const path = require('node:path');
const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// ─── Input parsing ─────────────────────────────────────────────────────────────

function parseInput() {
  const raw = process.argv.length > 2 ? process.argv.slice(2).join(' ') : '{}';
  try {
    return safeParseJSON(raw) || {};
  } catch (_err) {
    return {};
  }
}

// ─── Validation ────────────────────────────────────────────────────────────────

function validateInput(input) {
  const errors = [];
  const warnings = [];

  // Check GitHub token is available (required for MCP server)
  if (!process.env.GITHUB_PERSONAL_ACCESS_TOKEN) {
    warnings.push('GITHUB_PERSONAL_ACCESS_TOKEN is not set; GitHub MCP operations may fail');
  }

  // Validate context shape if provided
  if (input && typeof input === 'object') {
    // If toolsets are specified, validate they are an array or string
    if (input.toolsets !== undefined) {
      const ts = input.toolsets;
      if (!Array.isArray(ts) && typeof ts !== 'string') {
        errors.push('toolsets must be an array or comma-separated string');
      }
    }

    // If readOnly mode is specified, validate it's a boolean
    if (input.readOnly !== undefined && typeof input.readOnly !== 'boolean') {
      errors.push('readOnly must be a boolean');
    }
  }

  return { errors, warnings };
}

// ─── Main ──────────────────────────────────────────────────────────────────────

const input = parseInput();
const { errors, warnings } = validateInput(input);

console.log('[GITHUB-MCP] Pre-execute validation...');

if (warnings.length > 0) {
  for (const w of warnings) {
    console.warn(`[GITHUB-MCP] Warning: ${w}`);
  }
}

if (errors.length > 0) {
  console.error('[GITHUB-MCP] Validation failed:');
  for (const e of errors) {
    console.error(`  - ${e}`);
  }
  process.exit(1);
}

console.log('[GITHUB-MCP] Validation passed');
process.exit(0);

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "github-mcp Input Schema",
  "description": "Input validation schema for github-mcp skill",
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "github-mcp Output Schema",
  "description": "Output validation schema for github-mcp skill",
  "type": "object",
  "required": ["success"],
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the skill executed successfully"
    },
    "result": {
      "type": "object",
      "description": "The skill execution result",
      "additionalProperties": true
    },
    "error": {
      "type": "string",
      "description": "Error message if execution failed"
    }
  },
  "additionalProperties": true
}

#!/usr/bin/env node

/**
 * Github Mcp - Main Script
 * GitHub API operations - repositories, issues, pull requests, actions, code security, discussions, gists, and more. Use for GitHub-related tasks like managing PRs, issues, searching code, and monitoring workflows.
 *
 * Usage:
 *   node main.cjs [options]
 *
 * Options:
 *   --help     Show this help message
 */

const fs = require('fs');
const path = require('path');

// Find project root
function findProjectRoot() {
  let dir = __dirname;
  while (dir !== path.parse(dir).root) {
    if (fs.existsSync(path.join(dir, '.claude'))) {
      return dir;
    }
    dir = path.dirname(dir);
  }
  return process.cwd();
}

const PROJECT_ROOT = findProjectRoot();

// Parse command line arguments
const args = process.argv.slice(2);
const options = {};
for (let i = 0; i < args.length; i++) {
  if (args[i].startsWith('--')) {
    const key = args[i].slice(2);
    const value = args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true;
    options[key] = value;
  }
}

/**
 * Main execution
 */
function main() {
  if (options.help) {
    console.log(`
Github Mcp - Main Script

Usage:
  node main.cjs [options]

Options:
  --help     Show this help message
`);
    process.exit(0);
  }

  console.log(
    'GitHub MCP skill provides in-context guidance; configure GitHub MCP for full functionality. Invoke via the agent; no standalone script.'
  );
  process.exit(0);
}

main();