quinnjr/threads-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

18 stars 13 forks 质量 70 趋势 22MIT

Repository Install

为 Threads.com API 制作准备的模型背景协议服务器. 特性率限制,缓存,webhooks,以及完整的TypeScript支持. 将线索与克洛德,ChatGPT,以及AI助手融合.

概览

与 Threads.com API集成的强大模式上下文协议(MCP)服务器. 该服务器为程序创建,阅读和管理线索内容提供了综合工具. - QQ - 全面支持 Threads.com API v1.0 - QQ - 标准模型上下文协议执行 - 访问参与度量和分析 - QQ - 创建线程,答复,并管理对话 - QQ - 与Zod schema验证的完整类型Script支持 - QQ - 防止 API 率限制违规的Token buckle算法 - QX - 与 TTL 和 LRU 拆迁的入内存储 - QX - 以事件为基础的网络hooks 与自动重试和签名验证 - QQ- > 90% 测试覆盖 Vitest - QQ - 以最新的 npm 包和最佳做法构建 npm 包该服务器提供了以下MCP工具: - 获取经认证的用户配置信息 - - 用页码获取用户的线程(后端) - - - 通过ID获取特定线程 - - - 创建有文本,图像,或视频的新线程 - - - - - 回复...

概述（AI 翻译）

与 Threads.com API集成的强大模式上下文协议(MCP)服务器. 该服务器为程序创建,阅读和管理线索内容提供了综合工具.

为了更好的阅读体验,

□ 特性

- ** 完成线程 API 集成** - 完全支持线程.com API v1.0
** MCP议定书** – – 标准示范背景议定书的执行
分析与观察** - 访问参与度量和分析
** 汇编管理** - 创建线索、答复和管理对话
Type-Safe - 全面类型脚本支持,Zod schema验证防止 API 速率限制违反的 Token buckle 算法
与TTL和LRU拆迁的隐形牢房
Webhook Support - 基于事件、自动重试和签名验证的网络呼号
*** 试验合格** - > 90%试验范围
** 现代堆栈** - 以最新的npm软件包和最佳做法建成

□ 可用的工具

该服务器提供了以下MCP工具:

配置和内容管理

本页由 AI 翻译，技术细节请以原文为准。

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

新手？先看 mcpskill.org 教程 →

配置

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