Generate Image And Post MCP

🚀 Twitter MCP Server

Model Context Protocol (MCP) サーバーです。Claude や他の AI アシスタントが Twitter/X にテキストと画像をサポートしたツイートを投稿でき、AI による画像生成もサポートしています。

🚀 クイックスタート

この MCP サーバーを使用することで、Claude や他の AI アシスタントが Twitter/X へのツイート投稿や画像生成を行うことができます。以下の手順に従って、セットアップと使用を行いましょう。

✨ 主な機能

• OAuth 2.0 を介したテキストツイートの投稿
• OAuth 1.0a を介した画像のアップロードと添付（ツイートあたり最大 4 枚）
• 新機能: Google Gemini を使用した AI 画像生成
• OAuth 2.0 のトークン自動更新
• ~/.twitter_cli/ に安全な資格情報を保存
• 画像保存ディレクトリを設定可能
• 対話型 CLI ツールによる簡単なセットアップ

📦 インストール

# このパッケージをクローンまたはダウンロード
cd twitter-package

# 依存関係をインストール
npm install

📚 ドキュメント

事前準備

1. Node.js 18+ - ダウンロード
2. Twitter 開発者アカウント - サインアップ
3. 以下の設定がされた Twitter アプリ：
   • PKCE を有効にした OAuth 2.0
   • メディアアップロード用の OAuth 1.0a
   • 読み取りと書き込み権限
   • コールバック URL: http://localhost:8085/callback
4. Google Gemini API キー（画像生成用 - オプション） - API キーを取得

Twitter API 資格情報の取得

ステップ 1: Twitter 開発者アカウントを作成

1. Twitter 開発者ポータルにアクセスします。
2. Twitter アカウントでサインインします。
3. まだ開発者アカウントを持っていない場合は、申請します。
4. 新しいプロジェクトとアプリを作成します。

ステップ 2: アプリを設定

1. 開発者ポータルでアプリの設定にアクセスします。
2. "ユーザー認証設定" に移動します。
3. "設定" をクリックします。
4. 以下を設定します：
   • アプリの権限: "読み取りと書き込み" を選択します。
   • アプリの種類: "Web アプリ、自動化アプリ、またはボット" を選択します。
   • コールバック URI / リダイレクト URL: http://localhost:8085/callback を入力します。
   • ウェブサイト URL: 有効な URL（例: https://example.com）を入力します。

ステップ 3: OAuth 2.0 資格情報を取得

1. アプリ設定で、"キーとトークン" タブに移動します。
2. "OAuth 2.0 クライアント ID とクライアントシークレット" の下にある以下の情報を見つけます：
   • クライアント ID（ランダムな文字列で始まります）
   • クライアントシークレット（必要に応じて "再生成" をクリックします）
3. これらを OAuth 2.0 のセットアップに使用するために保存します。

ステップ 4: OAuth 1.0a 資格情報を取得

1. 同じ "キーとトークン" タブで、"認証トークン" の下にある以下の情報を見つけます：
   • API キー（Consumer Key とも呼ばれます）
   • API キーシークレット（Consumer Secret とも呼ばれます）
   • アクセストークン
   • アクセストークンシークレット
2. アクセストークン/シークレットが表示されない場合は、"生成" をクリックします。
3. これらを OAuth 1.0a のセットアップに使用するために保存します。

セットアップ

1. OAuth 2.0 のセットアップ（ツイート投稿に必要）

OAuth 2.0 のセットアップウィザードを実行します：

npm run setup-oauth2

以下の情報を入力するように求められます：

1. クライアント ID を入力します。
2. クライアントシークレット を入力します。
3. ブラウザでアプリを承認します。
4. 認証フローを完了します。

これにより、資格情報が ~/.twitter_cli/config.json と ~/.twitter_cli/tokens.json に保存されます。

2. OAuth 1.0a のセットアップ（画像アップロードに必要）

OAuth 1.0a のセットアップウィザードを実行します：

npm run setup-oauth1

以下の情報を入力するように求められます：

1. API キー（Consumer Key）を入力します。
2. API キーシークレット（Consumer Secret）を入力します。
3. アクセストークン を入力します。
4. アクセストークンシークレット を入力します。

これにより、資格情報が ~/.twitter_cli/oauth1_tokens.json に保存されます。

3. Google Gemini API のセットアップ（画像生成用 - オプション）

Gemini API のセットアップウィザードを実行します：

npm run setup-gemini

以下の情報を入力するように求められます：

1. Gemini API キー（https://aistudio.google.com/apikey から取得）を入力します。
2. 画像保存ディレクトリ を設定します（デフォルト: ~/.twitter_cli/generated_images）。

これにより、設定が ~/.twitter_cli/gemini.json に保存されます。

4. クイックセットアップ（すべてのサービス）

すべてのセットアップウィザードを順番に実行するには：

# Twitter のみ
npm run setup

# Twitter + Gemini（すべてを含む）
npm run setup:all

使用方法

MCP サーバーの起動

Twitter MCP サーバーを起動します：

npm start

画像生成 MCP サーバーを起動します：

npm run start:image

サーバーは標準入出力で実行され、Claude Desktop や他の MCP クライアントと一緒に使用できます。

Claude Desktop の設定

Claude Desktop の設定ファイルに以下を追加します： macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "twitter": {
      "command": "node",
      "args": ["/absolute/path/to/twitter-package/src/mcp-server/index.js"]
    },
    "generate-image": {
      "command": "node",
      "args": ["/absolute/path/to/twitter-package/src/mcp-server/generate-image.js"]
    }
  }
}

/absolute/path/to/twitter-package/ をこのディレクトリの実際のパスに置き換えてください。

注意: 両方のサーバーを Claude Desktop で同時に実行できます！

Claude との使用方法

設定が完了したら、Claude に以下のように要求できます： ツイートを投稿する:

Post a tweet saying "Hello from Claude! 👋"

画像付きのツイートを投稿する:

Post a tweet "Check out this amazing view!" with /path/to/image.jpg

AI 画像を生成する:

Generate an image of a futuristic cityscape at sunset

画像を生成してツイートする:

Generate an image of a cute robot, then post it to Twitter with the caption "Meet my new AI friend! 🤖"

MCP ツールリファレンス

post_tweet

オプションで画像を付けて Twitter/X にツイートを投稿します。 パラメーター:

• text（文字列、必須）: ツイートのテキスト（最大 280 文字）
• image_paths（文字列の配列、オプション）: 画像ファイルのパス（最大 4 枚）

返り値:

• ツイートの URL と ID を含む成功メッセージ

例:

{
  "text": "Hello from the MCP server!",
  "image_paths": ["/path/to/image1.jpg", "/path/to/image2.png"]
}

generate_image

Google の Gemini API を使用して、テキストプロンプトに基づいて AI 画像を生成します。 パラメーター:

• prompt（文字列、必須）: 生成する画像のテキスト説明

返り値:

• 生成された画像のパスと付随するテキスト

例:

{
  "prompt": "A serene mountain landscape at sunset with a lake reflection"
}

設定: 画像保存ディレクトリは以下の 3 つの方法で設定できます（優先順位）：

1. 環境変数: export TWITTER_MCP_IMAGE_DIR="/your/custom/path"
2. 設定ファイル: ~/.twitter_cli/gemini.json に "image_storage_dir": "/your/custom/path" を追加します。
3. デフォルト: ~/.twitter_cli/generated_images

ファイル構造

twitter-package/
├── package.json                 # パッケージの設定
├── README.md                    # このファイル
├── SETUP_GUIDE.md              # クイックセットアップガイド
├── src/
│   ├── mcp-server/
│   │   ├── index.js            # Twitter MCP サーバー
│   │   └── generate-image.js  # 画像生成 MCP サーバー
│   ├── auth/
│   │   ├── oauth2-setup.js     # OAuth 2.0 セットアップウィザード
│   │   ├── oauth1-setup.js     # OAuth 1.0a セットアップウィザード
│   │   └── gemini-setup.js     # Gemini API セットアップウィザード
│   └── lib/
│       └── config.js           # 共有設定ユーティリティ
└── ~/.twitter_cli/              # セットアップ中に作成されます
    ├── config.json             # OAuth 2.0 クライアント資格情報
    ├── tokens.json             # OAuth 2.0 アクセス/リフレッシュトークン
    ├── oauth1_tokens.json      # OAuth 1.0a 資格情報
    ├── gemini.json             # Gemini API 設定
    └── generated_images/       # 生成された画像の保存先（デフォルト）

設定ファイル

すべての設定ファイルは ~/.twitter_cli/ に安全なパーミッション（0600）で保存されます。

config.json（OAuth 2.0 クライアント資格情報）

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret"
}

tokens.json（OAuth 2.0 アクセストークン）

{
  "access_token": "...",
  "refresh_token": "...",
  "expires_at": 1234567890,
  "scope": "tweet.read tweet.write users.read offline.access"
}

oauth1_tokens.json（OAuth 1.0a 資格情報）

{
  "oauth1_api_key": "your_api_key",
  "oauth1_api_secret": "your_api_secret",
  "access_token": "your_access_token",
  "access_token_secret": "your_access_token_secret"
}

gemini.json（Gemini API 設定）

{
  "gemini_api_key": "your_gemini_api_key",
  "image_storage_dir": "/custom/path/to/images"
}

トラブルシューティング

認証エラー

エラー: "Not authenticated. Run 'npm run setup-oauth2' first."

• OAuth 2.0 のセットアップを実行する必要があります：npm run setup-oauth2

エラー: "OAuth 1.0a credentials not found. Run 'npm run setup-oauth1' first."

• OAuth 1.0a のセットアップを実行する必要があります：npm run setup-oauth1

エラー: "Failed to refresh token"

• リフレッシュトークンが期限切れになっている可能性があります
• OAuth 2.0 のセットアップを再実行します：npm run setup-oauth2

メディアアップロードエラー

エラー: "Failed to upload media"

• OAuth 1.0a のセットアップを実行していることを確認します：npm run setup-oauth1
• Twitter 開発者ポータルでアプリが "読み取りと書き込み" 権限を持っていることを確認します
• 画像ファイルが存在し、サポートされている形式（jpg、png、gif、webp）であることを確認します
• 画像が 15MB 未満であることを確認します

権限エラー

エラー: "403 Forbidden"

• アプリが正しい権限を持っていない可能性があります
• Twitter 開発者ポータル → あなたのアプリ → 設定にアクセスします
• "読み取りと書き込み" 権限が有効になっていることを確認します
• 権限を変更した後、トークンを再生成する必要がある場合があります

画像生成エラー

エラー: "Gemini API key not found. Run 'npm run setup-gemini' first."

• Gemini API のセットアップを行う必要があります：npm run setup-gemini

エラー: "Failed to generate image"

• Gemini API キーが有効であることを確認します
• https://aistudio.google.com/ で API クォータを確認します
• プロンプトが適切で、コンテンツポリシーに沿っていることを確認します
• よりシンプルまたは具体的なプロンプトを試してみます

エラー: "Image storage directory permission denied"

• 設定された保存ディレクトリに書き込み権限があることを確認します
• デフォルトの場所: ~/.twitter_cli/generated_images
• 必要に応じて ~/.twitter_cli/gemini.json でディレクトリを変更します

🔧 技術詳細

• すべての資格情報は ~/.twitter_cli/ に安全なファイルパーミッション（0600）で保存されます。
• OAuth 2.0 は PKCE（Proof Key for Code Exchange）を使用してセキュリティを強化しています。
• アクセストークンは期限切れになると自動的に更新されます。
• ~/.twitter_cli/ ディレクトリをバージョン管理にコミットしないでください。

📄 ライセンス

MIT

貢献

貢献は大歓迎です！問題やプルリクエストを自由に提出してください。

サポート

問題や質問については：

• Twitter API ドキュメントを確認します。
• MCP ドキュメントを確認します。
• GitHub で問題を開きます。

クレジット

以下のツールを使用して構築されています：

• Model Context Protocol SDK
• axios
• oauth-1.0a