quinnjr/threads-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

18 stars 13 forks 품질 70 트렌드 22MIT

Production-ready Model Context Protocol server for Threads.com API. Features rate limiting, caching, webhooks, and full TypeScript support. Integrate Threads with Claude, ChatGPT, and AI assistants.

개요

A powerful Model Context Protocol (MCP) server for integrating with the Threads.com API. This server provides comprehensive tools for creating, reading, and managing Threads content programmatically. - 🚀 - Full support for Threads.com API v1.0 - 🔧 - Standard Model Context Protocol implementation - 📊 - Access engagement metrics and analytics - 💬 - Create threads, replies, and manage conversations - 🎯 - Full TypeScript support with Zod schema validation - ⚡ - Token bucket algorithm to prevent API rate limit violations - 💾 - In-memory caching with TTL and LRU eviction - 🔔 - Event-based webhooks with automatic retries and signature verification - ✅ - >90% test coverage with Vitest - 🔄 - Built with latest npm packages and best practices The server provides the following MCP tools: - - Get authenticated user's profile information - - Retrieve user's threads (posts) with pagination - - Get a specific thread by ID - - Create new threads with text, images, or videos - - Reply to...

README

원문 README의 일부입니다. 원문 보기.

Threads MCP Server

A powerful Model Context Protocol (MCP) server for integrating with the Threads.com API. This server provides comprehensive tools for creating, reading, and managing Threads content programmatically.

🌐 Visit the Website for a better reading experience!

Features

🚀 Complete Threads API Integration - Full support for Threads.com API v1.0
🔧 MCP Protocol - Standard Model Context Protocol implementation
📊 Analytics & Insights - Access engagement metrics and analytics
💬 Conversation Management - Create threads, replies, and manage conversations
🎯 Type-Safe - Full TypeScript support with Zod schema validation
⚡ Rate Limiting - Token bucket algorithm to prevent API rate limit violations
💾 Caching Layer - In-memory caching with TTL and LRU eviction
🔔 Webhook Support - Event-based webhooks with automatic retries and signature verification
✅ Well Tested - >90% test coverage with Vitest
🔄 Modern Stack - Built with latest npm packages and best practices

Available Tools

The server provides the following MCP tools:

Profile & Content Management

threads_get_profile - Get authenticated user’s profile information
threads_get_threads - Retrieve user’s threads (posts) with pagination
threads_get_thread - Get a specific thread by ID
threads_create_thread - Create new threads with text, images, or videos
threads_reply_to_thread - Reply to existing threads

Engagement & Analytics

threads_get_insights - Get analytics for threads or user account
threads_get_replies - Retrieve replies to a specific thread
threads_get_conversation - Get full conversation threads

Prerequisites

Before you begin, you’ll need:

Node.js 18+ - Download here
pnpm - Install with npm install -g pnpm
Meta Developer Account - Sign up here
Threads Account - Your personal Threads account
OAuth 2.0 Credentials - See OAuth Setup Guide

Getting Your Threads API Credentials

⚠️ Important: Threads uses OAuth 2.0 authentication. You cannot use simple API keys.

Quick Setup (Automatic OAuth)

Create a Meta App
- Visit Meta for Developers
- Create a new app and add the Threads API product
- Add OAuth redirect URI: http://localhost:48810/callback
- Get your App ID and App Secret

GitHub에서 전체 README 보기

설치

npx -y @pegasusheavy/threads-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "threads": {
      "command": "npx",
      "args": ["-y", "@pegasusheavy/threads-mcp"],
      "env": {
        "THREADS_APP_ID": "your-app-id",
        "THREADS_APP_SECRET": "your-app-secret"
      }
    }
  }
}