Twitter X MCP Server

🚀 X ツール for Claude MCP

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

✨ 主な機能

• 自然言語検索：日常の言葉を使ってClaudeにTwitterを検索させることができます。
• Twitter検索：自然言語または高度なTwitter構文を使用してツイートを検索できます。
• 専用フォーマット：きれいなMarkdown形式でツイートを表示します。
• 柔軟な出力：生のツイートを表示するか、必要に応じて分析を追加して表示できます。
• 高度なフィルタリング：キーワード、ユーザー、日付、インタラクション指標などでツイートを検索できます。
• ページングサポート：デフォルトの20件を超えるツイート結果を取得できます。

📦 インストール

前提条件

• Node.js v16以上
• Claude for Desktop
• “Twitter154 API”にアクセスできるRapidAPIの無料キー

設定手順

1. mcp.jsonファイルを編集します：

   {
     "api_key": "your_rapidapi_key",
     "tools": {
       "x_tools": "path/to/xTools.js"
     }
   }
   

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

   npm install axios zod
   

3. Claude Desktopを再起動して設定を完了します

💻 使用例

基本的な使用法

formatTwitterResults()関数で、必要に応じて出力形式を調整します。例えば：

function formatTwitterResults(results) {
    return results.map(tweet => 
        `タイトル：${tweet.title}\nリンク：${tweet.url}\n内容：${tweet.content}`
    ).join('\n\n');
}

📚 ドキュメント

検索構文

以下の高度なフィルタリング条件をサポートしています：

• ユーザー名：
  • from:username — 特定のユーザーからのツイート
  • to:username — 特定のユーザー宛てのツイート
• メディアタイプ：
  • filter:links — リンクを含むツイート
  • filter:images — 画像を含むツイート
• 日付範囲：
  • since:YYYY-MM-DD — この日付より前に投稿されたツイート
  • until:YYYY-MM-DD — この日付より後に投稿されたツイート

よくある問題の解決方法

1. APIキーエラー：mcp.json内のキーが正しく設定されていることを確認します。
2. パスの問題：正しい絶対パスを使用し、Windowsシステムではバックスラッシュを使用します（例：C:\\path）。
3. 検索結果がない：クエリ条件が有効であり、過度に厳しくないことを確認します。

開発ガイド

1. ツールフォルダ内のコードを変更します。
2. formatTwitterResults()関数の出力形式を更新します。
3. 変更を適用するためにClaude Desktopを再起動します。

📄 ライセンス

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

謝辞

以下のプロジェクトの貢献に感謝します：

• Model Context Protocol (MCP) by Anthropic
• RapidAPI Twitter154 API
• Axios
• Zod