X Tools for Claude MCP

X Tools for Claude MCP

Claude が自然言語で効率的に Twitter を検索し、ユーザーの意図に基づいて結果を表示できる、軽量なオープンソースツールキットです。生データの表示にも、オプションの分析にも対応しています。

特徴

• 自然言語検索：Claude に英語で Twitter の検索を依頼できます
• Twitter 検索：自然言語または高度な Twitter 構文を使ってツイートを検索します
• 見やすいフォーマット：Markdown 形式でツイートをすっきり表示します
• 柔軟な出力：生のツイートを表示したり、依頼内容に応じて分析を追加したりできます
• 高度なフィルタリング：キーワード、ユーザー、日付、エンゲージメント指標などでツイートを検索できます
• ページネーション対応：必要に応じて、検索ごとのデフォルトの 20 件を超えるツイートを取得できます

インストール

前提条件

• Node.js v16+
• Claude for Desktop
• "The Old Bird API"（Twitter154）エンドポイントを利用できる無料の RapidAPI キー

RapidAPI キーの設定

1. RapidAPI の The Old Bird API にアクセスします
2. RapidAPI アカウントをお持ちでない場合は、登録します
3. API をサブスクライブします（無料プランを利用できます）
4. サブスクライブ後、ダッシュボードから RapidAPI キーをコピーします

セットアップ手順

1. このリポジトリをクローンします：

   git clone https://github.com/0xGval/twitter-X-mcp-server
   cd twitter-X-mcp-tools
   

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

   npm install
   

3. 設定を作成します：

   • mcp.json.example を Claude Desktop のディレクトリにある mcp.json にコピーします
   • mcp.json を編集し、RapidAPI キーと正しいファイルパスを設定します

   {
     "mcpServers": {
       "x-tools": {
         "command": "node",
         "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"],
         "env": {
           "RAPIDAPI_KEY": "your_rapidapi_key"
         }
       }
     }
   }
   

4. Claude for Desktop を設定します：

   • Windows の場合：mcp.json ファイルを %APPDATA%\Claude\ に配置します
   • macOS の場合：mcp.json ファイルを ~/Library/Application Support/Claude/ に配置します
   • claude-rules.md と knowledge/TwitterSearchSyntaxGuide.txt を Claude のナレッジベースディレクトリにコピーします
   • 変更を反映するため、Claude Desktop を再起動します

利用可能なツール

Twitter 検索

このツールは、主に自然言語での利用を想定して設計されています。Claude に Twitter で検索したい内容を伝えるだけで、依頼内容を解釈して検索します。

searchTwitter(query: "keyword", section: "latest", limit: 20)

自然言語または高度な構文を使って Twitter を検索します。

• query：検索クエリ（Twitter の高度な検索演算子に対応）
• section："latest" または "top" の結果（デフォルト："latest"）
• limit：返すツイートの数（デフォルト：20）

自然言語での例

シンプルなクエリ

Claude に次のように依頼します：

Show me recent tweets about artificial intelligence

ユーザーに焦点を当てたクエリ

Claude に次のように依頼します：

Find the latest tweets from Elon Musk that mention SpaceX

複雑な自然言語クエリ

Claude に次のように依頼します：

Search for tweets about climate change with at least 100 likes from the past month

分析の依頼

Claude に次のように依頼します：

What's the sentiment around the new Bitcoin ETF based on recent tweets?

構文を直接指定する例

構文を直接指定したい場合：

from:elonmusk spacex since:2023-01-01

"artificial intelligence" filter:images min_faves:100

climate action min_retweets:50 -filter:retweets

必要なファイル

このツールには、適切に設定する必要がある重要なファイルがいくつか含まれています。

• main.js：アプリケーションのメインファイル
• tools/twitter.js：Twitter 検索の実装
• claude-rules.md：検索結果を適切に表示するための Claude 向け指示
• knowledge/TwitterSearchSyntaxGuide.txt：Twitter 検索構文のリファレンスガイド

これらのファイルがすべて、Claude の設定で正しい場所に配置されていることを確認してください。

検索構文

このツールは、標準的な Twitter 検索演算子すべてに対応しており、Claude は自然言語での依頼に基づいて適用できます。

ユーザー

• from:username - 特定のアカウントが投稿したツイート
• to:username - 特定のアカウントへの返信
• @username - そのアカウントに言及しているツイート

メディアとリンク

• filter:media - メディアを含むツイート
• filter:images - 画像を含むツイート
• filter:native_video - 動画を含むツイート
• filter:links - リンクを含むツイート

日付

• since:YYYY-MM-DD - この日付以降のツイート
• until:YYYY-MM-DD - この日付より前のツイート

エンゲージメント

• min_retweets:n - リツイート数が n 件以上のツイート
• min_faves:n - いいね数が n 件以上のツイート
• min_replies:n - 返信数が n 件以上のツイート

トラブルシューティング

よくある問題：

• API キーが見つからない：RapidAPI キーが mcp.json に正しく設定されていることを確認してください
• パスのエラー：Windows では、適切にエスケープした完全な絶対パス（\\）を使用していることを確認してください
• 検索結果がない：検索クエリが有効で、絞り込みすぎていないことを確認してください
• Claude の動作に関する問題：柔軟な出力の指示が含まれている最新バージョンの claude-rules.md を使用していることを確認してください
• ファイルが見つからない：claude-rules.md と TwitterSearchSyntaxGuide.txt が Claude のルールとナレッジベースに正しく追加されていることを確認してください

開発

ツールを変更するには：

1. tools/ ディレクトリ内のファイルを編集します
2. 必要に応じて formatTwitterResults() 関数のフォーマットを更新します
3. 変更を確認するため、Claude for Desktop を再起動します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

謝辞

• Anthropic による Model Context Protocol（MCP）
• RapidAPI Twitter154 API
• Axios
• Zod

---

注：このツールは Claude AI アシスタントと連携し、ユーザーの意図に応じた柔軟な表示オプションで Twitter の検索結果を提供するよう設計されています。