threads-mcp

threads-mcp

这是一个基于 TypeScript 的 Node MCP（Model Context Protocol）服务，可用于在 Threads（Meta 的社交媒体平台）上创建帖子。

本项目旨在让大模型生成完整的社交媒体帖子——配上图片后即可发布到 Threads。因此，MCP 服务既负责获取相关视觉内容，也负责将模型输出编排成可直接使用的内容。它通过协同流程，将「猫」这样简单的查询转化为配有相关图片的精致帖子。

项目结构

threads-mcp
├── src
│   ├── index.ts                # Entry point 
│   ├── stock-photos.ts         # Unsplash http client
│   ├── threads-api.ts           # Threads Api HTTP Client
│   ├── threads-server.ts        # Threads MCP Server
│   └── types.ts                # Type definitions
├── package.json              # NPM package configuration
├── tsconfig.json             # TypeScript configuration
└── README.md                 # Project documentation

快速开始

前置条件

• 获取 Unsplash 的 API Key
• 在 Meta Developer 平台创建应用 https://developers.facebook.com/apps
• 选择 Access The Threads API 作为用例
• 在主控制面板中，点击 Access The Threads API > Settings > 输入 Redirect Callback URLS
• 获取以下密钥：Threads App ID、Threads App secret、Redirect Callback URL，并将它们保存到配置文件中 threads-dev 的 env 部分：

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

1. 克隆仓库：

git clone https://github.com/tttn13/threads-mcp
cd threads-mcp

2. 安装依赖：

npm install

3. 构建：

npm run build

4. 运行：

npm start

5. 创建 Meta Developer 账户并获取密钥

6. 将此配置添加到 Claude Desktop 配置文件中：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "threads-dev": {
      "command": "node",
      "args": [
        "/Users/path/to/project/build/index.js"
      ],
      "env": {
        "HOST": "https://graph.threads.net",
        "APP_ID": "threads_app_id",
        "APP_SECRET": "threads_app_secret",
        "REDIRECT_URI": "public_url",
        "INITIAL_USER_ID": "threads_user_id",
        "UNSPLASH_ACCESS_KEY":"access_key",
        "PORT": "3000",
      }
    },
}

3. 重启 Claude Desktop

完成！该工具现已正式连接到 Claude Desktop！你仍需完成授权流程以获取长期令牌，不过别担心，Claude 会引导你完成。

• post_thread：发布新帖子并从 Unsplash 获取图库照片

使用示例

尝试向 Claude 提问：

• “你能发布一条带照片的猫咪主题帖子吗？”

开发

如果你想参与贡献或从源代码运行：

1. 克隆仓库：

git clone https://github.com/tttn13/threads-mcp
cd threads-mcp

2. 安装依赖：

npm install

3. 构建：

npm run build

4. 运行：

npm start

许可证

本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。