Twitter MCP Server

🚀 Twitter MCP サーバー for Claude Desktop

このサーバーは Model Context Protocol (MCP) を利用し、Claude Desktop と Twitter を接続します。Twitter API を通じて、ツイートの投稿、内容分析、構成の良いツイートの作成などの機能を提供します。

🚀 クイックスタート

この MCP サーバーは、Twitter API を介して Claude Desktop を Twitter に接続し、様々な機能を提供します。

• リソース：Twitter のプロフィール、最近のツイート、トレンドを取得できます。
• ツール：ツイートの投稿、削除、内容分析が可能です。
• テンプレート：簡潔なツイート、Twitter スレッド、ユーザーエンゲージメントを目的としたコンテンツを作成するためのテンプレートが用意されています。

✨ 主な機能

リソース

• ユーザープロフィール (twitter://user/profile)：Twitter のプロフィール情報を取得します。
• 最近のツイート (twitter://user/tweets)：最新のツイートを取得します。
• トレンド (twitter://trends)：現在のトレンドを取得します。

ツール

• ツイート投稿：内容検証機能付きの新しいツイートを投稿します。
  • パラメータ：content（文字列、最大 280 文字）、dryRun（オプションのブール値）
• ツイート削除：ID を指定してツイートを削除します。
  • パラメータ：tweetId（文字列）
• ツイート分析：ツイート内容のエンゲージメント潜力を分析します。
  • パラメータ：content（文字列、最大 280 文字）

テンプレート

• 簡潔なツイート：短くて焦点のあるツイートを作成します。
  • パラメータ：topic（文字列）、include_hashtags（ブール値）、tone（列挙型：専門的、随意的、ユーモラス）
• Twitter スレッド：複数のツイートからなるスレッドを生成します。
  • パラメータ：topic（文字列）、points（数値、2 - 5）、include_call_to_action（ブール値）
• エンゲージメントツイート：高いエンゲージメントを目的としたツイートを作成します。
  • パラメータ：topic（文字列）、engagement_type（列挙型：質問、投票、人気のある意見、実用的なヒント）

📦 インストール

前提条件

• Node.js（v16 以上）
• Claude Desktop
• API キーを持つ Twitter 開発者アカウント

インストール手順

1. このリポジトリをクローンまたはダウンロードします。

   git clone https://github.com/yourusername/twitter-mcp-server
   cd twitter-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトのルートディレクトリに .env ファイルを作成し、Twitter API の認証情報を記述します。

   TWITTER_API_KEY=your_api_key
   TWITTER_API_SECRET=your_api_secret
   TWITTER_ACCESS_TOKEN=your_access_token
   TWITTER_ACCESS_SECRET=your_access_secret
   

💻 使用例

基本的な使用法

設定が完了したら、Claude Desktop に以下のような質問をすることができます。

• “Twitter で現在流行っているトピックは何ですか？”
• “人工知能に関する専門的なツイートを起草してください”
• “3 点を含む Twitter スレッドを作成してください”
• “最新のツイートを削除してください”
• “このツイートのエンゲージメント潜力を分析してください”

📚 ドキュメント

Claude Desktop との設定

1. Claude Desktop を開き、設定を開きます（メニューから、アプリケーション内ではなく）。
2. 左側のサイドバーで「開発者」をクリックし、「設定を編集」をクリックします。
3. Twitter MCP サーバーを設定に追加します。

{
    "mcpServers": {
        "Twitter アシスタント": {
            "command": "npm",
            "args": [
                "--prefix",
                "/full/path/to/twitter-mcp-server.js",
                "start"
            ]
        }
    }
}

4. /full/path/to/twitter-mcp-server.js を実際のサーバーファイルのパスに置き換えます。
5. 設定ファイルを保存し、Claude Desktop を再起動します。

ファイル構成

twitter-mcp-server/
├── index.js          # メインアプリケーションファイル
├── server.js        # HTTP サーバーのロジック
└── .env              # 環境変数の設定ファイル

トラブルシューティング

• 問題：サーバーが起動しない場合
  解決策：Node.js が正しくインストールされていること、すべての依存関係がインストールされていること、.env ファイルの認証情報が正しいことを確認してください。
• 問題：ツイートが投稿されない場合
  解決策：API キーが有効であること、ネットワーク接続が正常であること、コンソールのエラーメッセージを確認してください。

セキュリティに関する注意事項

• .env ファイルを安全に保管し、機密情報が漏洩しないようにしてください。
• API 認証情報を定期的に更新し、アカウントのセキュリティを維持してください。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。