Twitter MCP Server

🚀 Twitter MCP サーバー

AIエージェント向けに設計された強力なTwitter統合ツールで、Model Context Protocol (MCP) 標準を通じて包括的なTwitter機能を提供し、シンプルで一貫したインターフェースを備えています。

🚀 クイックスタート

このサーバーは、MCPツールを通じてTwitter機能へのアクセスを提供し、AIアシスタントや他のMCP互換クライアントとのシームレスな統合を実現します。agent - twitter - client ライブラリに基づいて構築され、強力なエラー処理、レート制限、および一貫したレスポンス形式を備えています。

✨ 主な機能

基本的な閲覧

• メディアサポート付きのユーザーツイートを取得
• 詳細なユーザープロファイル情報を取得
• hashtagまたはキーワードでツイートを検索
• 最新/人気で検索結果をフィルタリング
• レート制限保護（リクエストごとに最大50件のツイート）

ユーザーインタラクション

• ツイートをいいね/いいね解除
• ツイートをリツイート/リツイート解除
• ツイートを投稿（以下をサポート）：
  • テキストコンテンツ
  • メディア添付（画像、動画）
  • 返信機能
  • 引用ツイート機能

高度な機能

• ユーザー関係（フォロワー/フォローリスト）を取得
• トレンドトピックを取得
• さまざまなタイムラインタイプにアクセス：
  • アクティブタイムライン
  • フォロータイムライン
  • ユーザータイムライン
• リスト管理（リストのツイートを取得）

メディアおよび高度なインタラクション

• メディア処理：
  • 画像アップロード（JPEG, PNG, GIF）
  • 動画アップロード（MP4）
  • Altテキストサポート
• スレッドを作成
• ユーザーをフォロー/フォロー解除

🛠️ ツール

閲覧ツール

• get_tweets - ユーザーの最新ツイートを取得
• get_profile - ユーザープロファイル情報を取得
• search_tweets - hashtagまたはキーワードでツイートを検索

インタラクションツール

• like_tweet - ツイートをいいねまたはいいね解除
• retweet - ツイートをリツイートまたはリツイート解除
• post_tweet - 添付ファイルをサポートする新しいツイートを投稿
• create_thread - Twitterスレッドを作成

タイムラインツール

• get_timeline - さまざまなタイムラインタイプのツイートを取得
• get_list_tweets - リストのツイートを取得
• get_trends - 現在のトレンドトピックを取得

ユーザー管理ツール

• get_user_relationships - フォロワーまたはフォローリストを取得
• follow_user - ユーザーをフォローまたはフォロー解除

📦 インストール

1. 依存関係をインストール：

npm install

2. サーバーをビルド：

npm run build

3. 環境変数を設定：

# 必須：Twitterアカウントの認証情報（ユーザー認証用）
TWITTER_USERNAME=あなたのユーザー名
TWITTER_PASSWORD=あなたのパスワード
TWITTER_EMAIL=あなたのメールアドレス

# Twitter API認証（オプション）
TWITTER_API_KEY=あなたのAPIキー
TWITTER_API_SECRET_KEY=あなたのAPIキーシークレット
TWITTER_ACCESS_TOKEN=あなたのアクセストークン
TWITTER_ACCESS_TOKEN_SECRET=あなたのアクセストークンシークレット

4. 設定ファイルの例：

# .envファイルの例
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

💻 使用例

サーバーを初期化

npm run start

サンプルコマンド

# ツイートを取得する例
curl -X GET http://localhost:3000/api/tweets

# 新しいツイートを投稿する例
curl -X POST http://localhost:3000/api/tweets \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, Twitter!"}'

🔧 技術詳細

すべてのAPIリクエストはJSON形式のレスポンスを返します：

{
  "success": boolean,
  "error": string|null,
  "result": any
}

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細については LICENSE ファイルを参照してください。

🤝 貢献ガイド

プルリクエストを送信してこのプロジェクトに貢献することを歓迎します。詳細については CONTRIBUTING.md ファイルを読んでください。

Twitter MCPサーバーをご利用いただき、ありがとうございます！ヘルプが必要な場合は、GitHubページ を訪問するか、サポートメールアドレス support@twittermcp.com までご連絡ください。