threads-mcp

threads-mcp

このプロジェクトは、Threads（Meta のソーシャルメディアプラットフォーム）への投稿を作成する TypeScript ベースの Node MCP（Model Context Protocol）サーバーです。

このプロジェクトの目標は、画像とともに Threads にそのまま公開できる、完成したソーシャルメディア投稿を LLM に生成させることです。そのため、MCP サーバーは関連するビジュアルコンテンツの取得と、モデルの出力をそのまま使える形式にまとめる処理の両方を担います。「cats」のような単純なクエリを、ビジュアルを添えた洗練された投稿に変換する一連の処理を実現します。

プロジェクト構成

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 キーを取得します
• Meta Developer プラットフォームでアプリを作成します https://developers.facebook.com/apps
• ユースケースとして Access The Threads API を選択します
• メインダッシュボードで、Access The Threads API > Settings をクリックし、Redirect Callback URLS を入力します
• 次のキーを取得し、設定ファイルの threads-dev の env セクションに保存します：Threads App ID、Threads App secret、Redirect Callback URL

**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 ファイルをご覧ください。