mcp-http-webhook 1.0.29 → 1.0.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-http-webhook",
-  "version": "1.0.29",
+  "version": "1.0.30",
   "description": "Production-ready MCP server framework with HTTP + webhook-based subscriptions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,11 +29,7 @@
     "express": "^4.18.0"
   },
   "dependencies": {
-    "@ngrok/ngrok": "^1.5.2",
-    "@octokit/rest": "^20.0.0",
     "cors": "^2.8.5",
-    "googleapis": "^144.0.0",
-    "ngrok": "^4.3.3",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/ARCHITECTURE.md

@@ -1,269 +0,0 @@
-# MCP HTTP Webhook Architecture
-
-## System Architecture
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         MCP Client                               │
-│  ┌──────────────────────────────────────────────────────────┐  │
-│  │  - Calls tools via HTTP POST                              │  │
-│  │  - Reads resources via HTTP POST                          │  │
-│  │  - Subscribes with callback URL                           │  │
-│  │  - Receives notifications via webhook                     │  │
-│  └──────────────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────────┘
-         │                                              ▲
-         │ HTTP POST /mcp/tools/call                   │
-         │ HTTP POST /mcp/resources/read               │
-         │ HTTP POST /mcp/resources/subscribe          │
-         │                                              │ HTTP POST
-         ▼                                              │ (notification)
-┌─────────────────────────────────────────────────────────────────┐
-│                    MCP HTTP Webhook Server                       │
-│  ┌──────────────────────────────────────────────────────────┐  │
-│  │                  Express Application                      │  │
-│  │  ┌────────────┐ ┌─────────────┐ ┌──────────────────┐    │  │
-│  │  │ Protocol   │ │ Subscription│ │ Webhook          │    │  │
-│  │  │ Handler    │ │ Manager     │ │ Manager          │    │  │
-│  │  └────────────┘ └─────────────┘ └──────────────────┘    │  │
-│  └──────────────────────────────────────────────────────────┘  │
-│                           │                                      │
-│                           ▼                                      │
-│  ┌──────────────────────────────────────────────────────────┐  │
-│  │              Key-Value Store Interface                    │  │
-│  │         (Redis / DynamoDB / PostgreSQL)                  │  │
-│  │  - Subscription data                                      │  │
-│  │  - User indexes                                           │  │
-│  │  - Metadata                                               │  │
-│  └──────────────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────────┘
-         │                                              ▲
-         │ Register webhook                            │
-         │ (onSubscribe)                               │ HTTP POST
-         │                                              │ (third-party event)
-         ▼                                              │
-┌─────────────────────────────────────────────────────────────────┐
-│                    Third-Party Services                          │
-│  ┌────────────┐  ┌──────────┐  ┌──────┐  ┌──────────────┐     │
-│  │   GitHub   │  │  Slack   │  │ Drive│  │  PostgreSQL  │     │
-│  │  Webhooks  │  │  Events  │  │ Push │  │   NOTIFY     │     │
-│  └────────────┘  └──────────┘  └──────┘  └──────────────┘     │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Subscription Flow
-
-### 1. Subscribe Request
-
-```
-Client                    MCP Server                Third-Party
-  │                           │                          │
-  │ POST /resources/subscribe │                          │
-  │ {                         │                          │
-  │   uri: "...",             │                          │
-  │   callbackUrl: "..."      │                          │
-  │ }                         │                          │
-  │──────────────────────────>│                          │
-  │                           │                          │
-  │                           │ Generate subscriptionId  │
-  │                           │ Create webhook URL       │
-  │                           │                          │
-  │                           │ Register webhook         │
-  │                           │─────────────────────────>│
-  │                           │                          │
-  │                           │ Store in KV store        │
-  │                           │                          │
-  │ Response:                 │                          │
-  │ { subscriptionId: "..." } │                          │
-  │<──────────────────────────│                          │
-```
-
-### 2. Webhook Notification Flow
-
-```
-Third-Party              MCP Server                  Client
-  │                           │                          │
-  │ POST /webhooks/incoming/  │                          │
-  │      {subscriptionId}     │                          │
-  │──────────────────────────>│                          │
-  │                           │                          │
-  │                           │ Load subscription        │
-  │                           │ from KV store            │
-  │                           │                          │
-  │                           │ Process webhook          │
-  │                           │ (onWebhook handler)      │
-  │                           │                          │
-  │ 200 OK                    │                          │
-  │<──────────────────────────│                          │
-  │                           │                          │
-  │                           │ POST to callbackUrl      │
-  │                           │ {                        │
-  │                           │   subscriptionId,        │
-  │                           │   resourceUri,           │
-  │                           │   changeType,            │
-  │                           │   data                   │
-  │                           │ }                        │
-  │                           │─────────────────────────>│
-  │                           │                          │
-  │                           │        200 OK            │
-  │                           │<─────────────────────────│
-```
-
-## Component Interaction
-
-### Protocol Handler
-- Handles MCP protocol messages
-- Validates input using JSON Schema
-- Executes tool handlers
-- Reads resources
-- Returns formatted responses
-
-### Subscription Manager
-- Creates and deletes subscriptions
-- Manages subscription lifecycle
-- Stores data in KV store
-- Maintains user indexes
-- Verifies ownership
-
-### Webhook Manager
-- Processes incoming webhooks
-- Verifies signatures
-- Calls client callbacks
-- Implements retry logic
-- Handles timeouts
-
-### Key-Value Store
-- Stores subscription data
-- Maintains indexes
-- Supports TTL
-- Provides scan functionality
-- Enables horizontal scaling
-
-## Data Flow
-
-### Tool Call
-
-```
-1. Client sends HTTP POST to /mcp/tools/call
-2. Server authenticates request
-3. ProtocolHandler validates input against JSON Schema
-4. Tool handler executes
-5. Response returned to client
-```
-
-### Resource Read
-
-```
-1. Client sends HTTP POST to /mcp/resources/read
-2. Server authenticates request
-3. ProtocolHandler finds resource by URI
-4. Resource read handler executes
-5. Contents returned to client
-```
-
-### Subscription Creation
-
-```
-1. Client sends HTTP POST to /mcp/resources/subscribe
-2. Server authenticates request
-3. SubscriptionManager generates ID and webhook URL
-4. Resource onSubscribe handler called
-5. Handler registers with third-party service
-6. Subscription stored in KV store
-7. Subscription ID returned to client
-```
-
-### Notification Delivery
-
-```
-1. Third-party sends webhook to /webhooks/incoming/{id}
-2. Server loads subscription from KV store
-3. Resource onWebhook handler processes payload
-4. WebhookManager signs and sends to client callback
-5. Retry on failure with exponential backoff
-6. Dead letter queue if all retries fail
-```
-
-## Scaling Strategy
-
-### Horizontal Scaling
-
-```
-┌─────────────┐
-│Load Balancer│
-└──────┬──────┘
-       │
-       ├──────────┬──────────┬──────────┐
-       │          │          │          │
-       ▼          ▼          ▼          ▼
-   ┌─────┐    ┌─────┐    ┌─────┐    ┌─────┐
-   │MCP 1│    │MCP 2│    │MCP 3│    │MCP N│
-   └──┬──┘    └──┬──┘    └──┬──┘    └──┬──┘
-      │          │          │          │
-      └──────────┴──────────┴──────────┘
-                 │
-                 ▼
-           ┌──────────┐
-           │  Redis   │
-           │ Cluster  │
-           └──────────┘
-```
-
-Benefits:
-- No session affinity required
-- Simple round-robin load balancing
-- Shared state in Redis
-- Independent instance scaling
-- Zero-downtime deployments
-
-## Security Layers
-
-```
-┌─────────────────────────────────────┐
-│     HTTPS/TLS (Required)            │
-└─────────────────────────────────────┘
-┌─────────────────────────────────────┐
-│  Authentication Middleware          │
-│  (JWT, API Key, OAuth2)             │
-└─────────────────────────────────────┘
-┌─────────────────────────────────────┐
-│  Webhook Signature Verification     │
-│  (HMAC SHA-256, Timing-Safe)        │
-└─────────────────────────────────────┘
-┌─────────────────────────────────────┐
-│  Input Validation                   │
-│  (JSON Schema, AJV)                 │
-└─────────────────────────────────────┘
-┌─────────────────────────────────────┐
-│  Rate Limiting                      │
-│  (Optional Middleware)              │
-└─────────────────────────────────────┘
-```
-
-## Performance Optimizations
-
-1. **Connection Pooling**
-   - HTTP keep-alive
-   - Redis connection pool
-   - Database connection pool
-
-2. **Caching**
-   - Resource read results
-   - Tool metadata
-   - Configuration data
-
-3. **Async Processing**
-   - Non-blocking I/O
-   - Promise-based handlers
-   - Background webhook delivery
-
-4. **Retry Strategy**
-   - Exponential backoff
-   - Circuit breaker pattern
-   - Dead letter queue
-
-5. **Monitoring**
-   - Prometheus metrics
-   - Structured logging
-   - Health check endpoints
-   - Distributed tracing