@pegasusheavy/threads-mcp 1.0.0

package/dist/utils/rate-limiter.js

@@ -0,0 +1,99 @@
+export class RateLimiter {
+    tokens;
+    lastRefill;
+    maxTokens;
+    refillRate;
+    refillInterval;
+    constructor(options) {
+        this.maxTokens = options.maxTokens;
+        this.refillRate = options.refillRate;
+        this.refillInterval = options.refillInterval || 1000;
+        this.tokens = this.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const intervalsElapsed = elapsed / this.refillInterval;
+        const tokensToAdd = intervalsElapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    tryConsume(tokens = 1) {
+        this.refill();
+        if (this.tokens >= tokens) {
+            this.tokens -= tokens;
+            return true;
+        }
+        return false;
+    }
+    async consume(tokens = 1) {
+        while (!this.tryConsume(tokens)) {
+            const waitTime = this.getWaitTime(tokens);
+            await new Promise((resolve) => setTimeout(resolve, waitTime));
+        }
+    }
+    getWaitTime(tokens = 1) {
+        this.refill();
+        if (this.tokens >= tokens) {
+            return 0;
+        }
+        const tokensNeeded = tokens - this.tokens;
+        const intervalsNeeded = Math.ceil(tokensNeeded / this.refillRate);
+        return intervalsNeeded * this.refillInterval;
+    }
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+    reset() {
+        this.tokens = this.maxTokens;
+        this.lastRefill = Date.now();
+    }
+}
+export class RateLimiterManager {
+    limiters;
+    constructor() {
+        this.limiters = new Map();
+    }
+    register(endpoint, options) {
+        this.limiters.set(endpoint, new RateLimiter(options));
+    }
+    tryConsume(endpoint, tokens = 1) {
+        const limiter = this.limiters.get(endpoint);
+        if (!limiter) {
+            return true;
+        }
+        return limiter.tryConsume(tokens);
+    }
+    async consume(endpoint, tokens = 1) {
+        const limiter = this.limiters.get(endpoint);
+        if (limiter) {
+            await limiter.consume(tokens);
+        }
+    }
+    getWaitTime(endpoint, tokens = 1) {
+        const limiter = this.limiters.get(endpoint);
+        return limiter ? limiter.getWaitTime(tokens) : 0;
+    }
+    reset(endpoint) {
+        const limiter = this.limiters.get(endpoint);
+        if (limiter) {
+            limiter.reset();
+        }
+    }
+    resetAll() {
+        this.limiters.forEach((limiter) => limiter.reset());
+    }
+}
+export function RateLimited(limiter, tokens = 1) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            await limiter.consume(tokens);
+            return originalMethod.apply(this, args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/utils/webhook.d.ts

@@ -0,0 +1,67 @@
+import { EventEmitter } from 'events';
+export interface WebhookSubscription {
+    id: string;
+    url: string;
+    events: string[];
+    secret?: string;
+    active: boolean;
+    createdAt: Date;
+    lastTriggered?: Date;
+}
+export interface WebhookPayload {
+    event: string;
+    timestamp: Date;
+    data: any;
+    subscriptionId: string;
+}
+export interface WebhookDelivery {
+    id: string;
+    subscriptionId: string;
+    event: string;
+    payload: WebhookPayload;
+    status: 'pending' | 'success' | 'failed';
+    attempts: number;
+    lastAttempt?: Date;
+    response?: {
+        status: number;
+        body: string;
+    };
+}
+export interface WebhookOptions {
+    maxRetries?: number;
+    retryDelay?: number;
+    timeout?: number;
+}
+export declare class WebhookManager extends EventEmitter {
+    private subscriptions;
+    private deliveries;
+    private readonly maxRetries;
+    private readonly retryDelay;
+    private readonly timeout;
+    constructor(options?: WebhookOptions);
+    subscribe(url: string, events: string[], secret?: string): WebhookSubscription;
+    unsubscribe(subscriptionId: string): boolean;
+    updateSubscription(subscriptionId: string, updates: Partial<Pick<WebhookSubscription, 'url' | 'events' | 'secret' | 'active'>>): WebhookSubscription | null;
+    getSubscription(subscriptionId: string): WebhookSubscription | undefined;
+    getSubscriptions(): WebhookSubscription[];
+    getSubscriptionsForEvent(event: string): WebhookSubscription[];
+    trigger(event: string, data: any): Promise<WebhookDelivery[]>;
+    private deliverWebhook;
+    private attemptDelivery;
+    private sendWebhook;
+    private generateSignature;
+    static verifySignature(payload: string, signature: string, secret: string): boolean;
+    getDelivery(deliveryId: string): WebhookDelivery | undefined;
+    getDeliveriesForSubscription(subscriptionId: string): WebhookDelivery[];
+    cleanDeliveries(olderThan: Date): number;
+    private generateId;
+    private delay;
+    stats(): {
+        subscriptions: number;
+        activeSubscriptions: number;
+        deliveries: number;
+        successfulDeliveries: number;
+        failedDeliveries: number;
+    };
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/utils/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/utils/webhook.ts"],"names":[],"mappings":"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"}

package/dist/utils/webhook.js

@@ -0,0 +1,187 @@
+import crypto from 'crypto';
+import { EventEmitter } from 'events';
+export class WebhookManager extends EventEmitter {
+    subscriptions;
+    deliveries;
+    maxRetries;
+    retryDelay;
+    timeout;
+    constructor(options = {}) {
+        super();
+        this.subscriptions = new Map();
+        this.deliveries = new Map();
+        this.maxRetries = options.maxRetries || 3;
+        this.retryDelay = options.retryDelay || 1000;
+        this.timeout = options.timeout || 5000;
+    }
+    subscribe(url, events, secret) {
+        const subscription = {
+            id: this.generateId(),
+            url,
+            events,
+            secret,
+            active: true,
+            createdAt: new Date(),
+        };
+        this.subscriptions.set(subscription.id, subscription);
+        this.emit('subscription:created', subscription);
+        return subscription;
+    }
+    unsubscribe(subscriptionId) {
+        const subscription = this.subscriptions.get(subscriptionId);
+        if (!subscription) {
+            return false;
+        }
+        this.subscriptions.delete(subscriptionId);
+        this.emit('subscription:deleted', subscription);
+        return true;
+    }
+    updateSubscription(subscriptionId, updates) {
+        const subscription = this.subscriptions.get(subscriptionId);
+        if (!subscription) {
+            return null;
+        }
+        Object.assign(subscription, updates);
+        this.emit('subscription:updated', subscription);
+        return subscription;
+    }
+    getSubscription(subscriptionId) {
+        return this.subscriptions.get(subscriptionId);
+    }
+    getSubscriptions() {
+        return Array.from(this.subscriptions.values());
+    }
+    getSubscriptionsForEvent(event) {
+        return Array.from(this.subscriptions.values()).filter((sub) => sub.active && (sub.events.includes('*') || sub.events.includes(event)));
+    }
+    async trigger(event, data) {
+        const subscriptions = this.getSubscriptionsForEvent(event);
+        const deliveries = [];
+        for (const subscription of subscriptions) {
+            const delivery = await this.deliverWebhook(subscription, event, data);
+            deliveries.push(delivery);
+        }
+        return deliveries;
+    }
+    async deliverWebhook(subscription, event, data) {
+        const payload = {
+            event,
+            timestamp: new Date(),
+            data,
+            subscriptionId: subscription.id,
+        };
+        const delivery = {
+            id: this.generateId(),
+            subscriptionId: subscription.id,
+            event,
+            payload,
+            status: 'pending',
+            attempts: 0,
+        };
+        this.deliveries.set(delivery.id, delivery);
+        await this.attemptDelivery(subscription, delivery);
+        return delivery;
+    }
+    async attemptDelivery(subscription, delivery) {
+        for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+            delivery.attempts = attempt + 1;
+            delivery.lastAttempt = new Date();
+            try {
+                const response = await this.sendWebhook(subscription, delivery.payload);
+                delivery.status = 'success';
+                delivery.response = response;
+                subscription.lastTriggered = new Date();
+                this.emit('delivery:success', delivery);
+                return;
+            }
+            catch (error) {
+                delivery.status = 'failed';
+                delivery.response = {
+                    status: 0,
+                    body: error instanceof Error ? error.message : 'Unknown error',
+                };
+                this.emit('delivery:failed', delivery, error);
+                if (attempt < this.maxRetries - 1) {
+                    await this.delay(this.retryDelay * Math.pow(2, attempt));
+                }
+            }
+        }
+    }
+    async sendWebhook(subscription, payload) {
+        const body = JSON.stringify(payload);
+        const signature = subscription.secret
+            ? this.generateSignature(body, subscription.secret)
+            : undefined;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(subscription.url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'Threads-MCP-Webhook/1.0',
+                    ...(signature && { 'X-Webhook-Signature': signature }),
+                },
+                body,
+                signal: controller.signal,
+            });
+            const responseBody = await response.text();
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${responseBody}`);
+            }
+            return {
+                status: response.status,
+                body: responseBody,
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    generateSignature(payload, secret) {
+        return crypto.createHmac('sha256', secret).update(payload).digest('hex');
+    }
+    static verifySignature(payload, signature, secret) {
+        const expectedSignature = crypto
+            .createHmac('sha256', secret)
+            .update(payload)
+            .digest('hex');
+        if (signature.length !== expectedSignature.length) {
+            return false;
+        }
+        return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));
+    }
+    getDelivery(deliveryId) {
+        return this.deliveries.get(deliveryId);
+    }
+    getDeliveriesForSubscription(subscriptionId) {
+        return Array.from(this.deliveries.values()).filter((delivery) => delivery.subscriptionId === subscriptionId);
+    }
+    cleanDeliveries(olderThan) {
+        let cleaned = 0;
+        this.deliveries.forEach((delivery, id) => {
+            if (delivery.lastAttempt && delivery.lastAttempt < olderThan) {
+                this.deliveries.delete(id);
+                cleaned++;
+            }
+        });
+        return cleaned;
+    }
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    stats() {
+        const deliveryArray = Array.from(this.deliveries.values());
+        return {
+            subscriptions: this.subscriptions.size,
+            activeSubscriptions: Array.from(this.subscriptions.values()).filter((sub) => sub.active).length,
+            deliveries: this.deliveries.size,
+            successfulDeliveries: deliveryArray.filter((d) => d.status === 'success').length,
+            failedDeliveries: deliveryArray.filter((d) => d.status === 'failed').length,
+        };
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/utils/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/utils/webhook.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,197 @@
+# Threads MCP Server
+
+> Production-ready Model Context Protocol server for Threads.com API
+
+## Overview
+
+Threads MCP Server enables AI assistants like Claude and ChatGPT to interact with the Threads.com API through the Model Context Protocol. Built with TypeScript, featuring rate limiting, caching, and webhooks.
+
+## Repository
+
+- GitHub: https://github.com/pegasusheavy/threads-mcp
+- Website: https://pegasusheavy.github.io/threads-mcp/
+- License: MIT (Pegasus Heavy Industries LLC)
+
+## Key Features
+
+- Complete Threads.com API integration
+- Rate limiting with token bucket algorithm
+- In-memory caching with TTL and LRU eviction
+- Webhook support with HMAC signature verification
+- Full TypeScript support with Zod validation
+- 90%+ test coverage with Vitest
+- Claude Desktop integration ready
+
+## Installation
+
+```bash
+npm install threads-mcp
+# or
+pnpm add threads-mcp
+```
+
+## Configuration
+
+Set environment variables:
+```bash
+THREADS_ACCESS_TOKEN="your-access-token"
+THREADS_USER_ID="your-user-id"
+```
+
+Add to Claude Desktop config (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "threads": {
+      "command": "threads-mcp",
+      "env": {
+        "THREADS_ACCESS_TOKEN": "your-token",
+        "THREADS_USER_ID": "your-user-id"
+      }
+    }
+  }
+}
+```
+
+## Available MCP Tools
+
+- `threads_get_profile` - Get authenticated user's profile
+- `threads_get_threads` - List user's threads with pagination
+- `threads_get_thread` - Get specific thread by ID
+- `threads_create_thread` - Create text, image, or video threads
+- `threads_reply_to_thread` - Reply to existing threads
+- `threads_get_insights` - Get thread analytics and metrics
+- `threads_get_replies` - Get all replies to a thread
+- `threads_get_conversation` - Get full conversation thread
+
+## Usage Examples
+
+### Basic Client Usage
+```typescript
+import { ThreadsClient } from 'threads-mcp';
+
+const client = new ThreadsClient({
+  accessToken: process.env.THREADS_ACCESS_TOKEN,
+  userId: process.env.THREADS_USER_ID,
+});
+
+// Create a thread
+const thread = await client.createThread({
+  text: 'Hello from Threads MCP! 🚀',
+});
+
+// Get profile
+const profile = await client.getProfile(['id', 'username', 'threads_profile_picture_url']);
+```
+
+### Enhanced Client with Rate Limiting & Caching
+```typescript
+import { EnhancedThreadsClient } from 'threads-mcp';
+
+const client = new EnhancedThreadsClient({
+  accessToken: process.env.THREADS_ACCESS_TOKEN,
+  userId: process.env.THREADS_USER_ID,
+  rateLimit: {
+    maxRequests: 100,
+    windowMs: 60000,
+  },
+  cache: {
+    ttl: 300000,
+    maxSize: 100,
+  },
+});
+```
+
+## Claude Prompts
+
+Try these with Claude Desktop after installing:
+- "Show me my Threads profile information"
+- "Post a thread saying 'Hello from Claude! 👋'"
+- "Get analytics for my most recent thread"
+- "Show me my last 10 threads"
+- "Reply to thread ID xyz with 'Great post!'"
+
+## Project Structure
+
+```
+src/
+├── client/              # API client implementation
+│   ├── threads-client.ts
+│   └── enhanced-threads-client.ts
+├── server.ts           # MCP server implementation
+├── types/              # TypeScript types and Zod schemas
+├── utils/              # Rate limiting, caching, webhooks
+└── index.ts            # Entry point
+
+docs/                   # GitHub Pages site (Threads-style)
+examples/               # Usage examples
+```
+
+## Testing
+
+```bash
+pnpm test              # Run all tests
+pnpm test:coverage     # Generate coverage report
+pnpm build             # Build for production
+pnpm lint              # Run ESLint
+```
+
+## Technical Stack
+
+- **Language**: TypeScript
+- **Runtime**: Node.js
+- **Protocol**: Model Context Protocol (MCP)
+- **Validation**: Zod
+- **HTTP Client**: Axios
+- **Testing**: Vitest
+- **Coverage**: 90%+ (statements, branches, functions, lines)
+
+## API Coverage
+
+Implements full Threads API including:
+- Profile management
+- Thread creation (text, images, videos)
+- Thread replies and conversations
+- Analytics and insights
+- Media handling
+- Rate limiting compliance
+
+## Advanced Features
+
+### Rate Limiting
+- Token bucket algorithm
+- Configurable limits per endpoint
+- Automatic retry with backoff
+- Request queuing
+
+### Caching
+- In-memory cache with TTL
+- LRU eviction policy
+- Automatic cleanup
+- Cache invalidation
+
+### Webhooks
+- Event subscription
+- HMAC-SHA256 signature verification
+- Automatic retries with exponential backoff
+- Event filtering
+
+## Documentation
+
+- Full API Reference: https://pegasusheavy.github.io/threads-mcp/API.html
+- Usage Examples: https://pegasusheavy.github.io/threads-mcp/EXAMPLES.html
+- GitHub: https://github.com/pegasusheavy/threads-mcp
+
+## Contributing
+
+See CONTRIBUTING.md for guidelines.
+
+## License
+
+MIT License - Copyright (c) 2025 Pegasus Heavy Industries LLC
+
+## Contact
+
+- GitHub Issues: https://github.com/pegasusheavy/threads-mcp/issues
+- Repository: https://github.com/pegasusheavy/threads-mcp
+

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@pegasusheavy/threads-mcp",
+  "version": "1.0.0",
+  "description": "A powerful MCP server for Threads.com API integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "threads-mcp": "dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "threads",
+    "meta",
+    "social-media",
+    "api"
+  ],
+  "author": "Pegasus Heavy Industries LLC",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.7.9",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.2.0",
+    "@commitlint/config-conventional": "^20.2.0",
+    "@types/node": "^22.10.2",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.17.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md}": [
+      "prettier --write"
+    ]
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  }
+}