mcp-http-webhook 1.0.0

package/examples/start-github-live.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+
+# GitHub MCP Live Integration Helper Script
+
+set -e
+
+echo "╔═══════════════════════════════════════════════════════════╗"
+echo "║  GitHub MCP Server - Setup Helper                       ║"
+echo "╚═══════════════════════════════════════════════════════════╝"
+echo ""
+
+# Check if ngrok auth token is set
+if [ -z "$NGROK_AUTH_TOKEN" ]; then
+    echo "⚠️  ngrok auth token not found in environment"
+    echo ""
+    echo "To fix this:"
+    echo "1. Sign up for free ngrok account: https://dashboard.ngrok.com/signup"
+    echo "2. Get your auth token: https://dashboard.ngrok.com/get-started/your-authtoken"
+    echo "3. Run: export NGROK_AUTH_TOKEN='your_token_here'"
+    echo ""
+    read -p "Press Enter to continue (you'll be prompted for token)..."
+else
+    echo "✅ ngrok auth token found in environment"
+fi
+
+echo ""
+echo "📋 Prerequisites Checklist:"
+echo ""
+echo "1. GitHub Personal Access Token"
+echo "   Create at: https://github.com/settings/tokens/new"
+echo "   Scopes needed: repo, admin:repo_hook"
+echo ""
+echo "2. Test Repository"
+echo "   Use any repo you own, or create: gh repo create mcp-test --public"
+echo ""
+echo "3. ngrok Auth Token (if not set above)"
+echo "   Get from: https://dashboard.ngrok.com/get-started/your-authtoken"
+echo ""
+
+read -p "Ready to start? (y/n) " -n 1 -r
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Setup cancelled."
+    exit 0
+fi
+
+echo ""
+echo "🚀 Starting GitHub MCP Live Server..."
+echo ""
+
+cd "$(dirname "$0")/.."
+npx tsx examples/github-server-live.ts

package/jest.config.js

@@ -0,0 +1,20 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/**/*.test.ts',
+    '!src/**/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80
+    }
+  }
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "mcp-http-webhook",
+  "version": "1.0.0",
+  "description": "Production-ready MCP server framework with HTTP + webhook-based subscriptions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run lint && npm run type-check",
+    "publish": "npm run build && npm publish --access public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "webhook",
+    "http",
+    "ai",
+    "llm"
+  ],
+  "author": "Your Organization",
+  "license": "MIT",
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "express": "^4.18.0"
+  },
+  "dependencies": {
+    "@ngrok/ngrok": "^1.5.2",
+    "@octokit/rest": "^20.0.0",
+    "cors": "^2.8.5",
+    "nanoid": "^5.0.0",
+    "ngrok": "^4.3.3",
+    "zod": "^3.22.0",
+    "googleapis": "^144.0.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "optionalDependencies": {
+    "ioredis": "^5.3.0",
+    "prom-client": "^15.0.0"
+  }
+}

package/src/errors/index.ts

@@ -0,0 +1,81 @@
+import { MCPErrorCode } from '../types';
+
+/**
+ * Base MCP Error class
+ */
+export class MCPError extends Error {
+  code: number;
+  data?: any;
+
+  constructor(message: string, code: number, data?: any) {
+    super(message);
+    this.name = this.constructor.name;
+    this.code = code;
+    this.data = data;
+    Error.captureStackTrace(this, this.constructor);
+  }
+
+  toJSON() {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        data: this.data,
+      },
+    };
+  }
+}
+
+/**
+ * Authentication error
+ */
+export class AuthenticationError extends MCPError {
+  constructor(message = 'Authentication failed', data?: any) {
+    super(message, MCPErrorCode.AuthenticationError, data);
+  }
+}
+
+/**
+ * Validation error
+ */
+export class ValidationError extends MCPError {
+  constructor(message = 'Validation failed', data?: any) {
+    super(message, MCPErrorCode.ValidationError, data);
+  }
+}
+
+/**
+ * Resource not found error
+ */
+export class ResourceNotFoundError extends MCPError {
+  constructor(message = 'Resource not found', data?: any) {
+    super(message, MCPErrorCode.ResourceNotFoundError, data);
+  }
+}
+
+/**
+ * Tool execution error
+ */
+export class ToolExecutionError extends MCPError {
+  constructor(message = 'Tool execution failed', data?: any) {
+    super(message, MCPErrorCode.ToolExecutionError, data);
+  }
+}
+
+/**
+ * Webhook error
+ */
+export class WebhookError extends MCPError {
+  constructor(message = 'Webhook error', data?: any) {
+    super(message, MCPErrorCode.WebhookError, data);
+  }
+}
+
+/**
+ * Storage error
+ */
+export class StorageError extends MCPError {
+  constructor(message = 'Storage error', data?: any) {
+    super(message, MCPErrorCode.StorageError, data);
+  }
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+// Main export
+export { createMCPServer } from './server';
+
+// Types
+export * from './types';
+
+// Errors
+export * from './errors';
+
+// Utilities
+export * from './utils';
+
+// Managers (for advanced usage)
+export { SubscriptionManager } from './subscriptions/SubscriptionManager';
+export { WebhookManager } from './webhooks/WebhookManager';
+
+// Store implementations
+export { InMemoryStore } from './stores/InMemoryStore';
+export { RedisStore } from './stores/RedisStore';