Skip to main content
Glama
Twitter MCP Server

Twitter MCP Server

by 6551Team

クイックインストール

まず、http://app.newsliquid.com/mcp にアクセスして API トークンを取得してください。

Claude Code

claude mcp add twitter \
  -e OPENNEWS_TOKEN=<your-token> \
  -- uv --directory /path/to/twitter-mcp run twitter-mcp

/path/to/twitter-mcp をローカルのプロジェクトパスに、<your-token> をあなたのトークンに置き換えてください。

OpenClaw

export OPENNEWS_TOKEN="<your-token>"
cp -r openclaw-skill/opentwitter ~/.openclaw/skills/

Related MCP server: Apex MCP for X Management

AI にレビューとインストールを任せる

この MCP が安全かどうか不安ですか?以下のプロンプトを AI アシスタントに貼り付けてください。まずソースコードをレビューし、安全であればインストールします:

このプロンプトをコピーして AI アシスタントに送信してください(<project-path> と <your-token> は実際の値に置き換えてください):

Please review and install the twitter-mcp MCP server for me. The project is at <project-path>.

Steps:
1. Review these files for security:
   - src/twitter_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
   - src/twitter_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
   - src/twitter_mcp/tools.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
   - pyproject.toml — Confirm dependencies are only mcp, httpx, no suspicious packages
2. Tell me your conclusion: safe / risky / problematic, with specific reasons
3. If safe, run the install (get Token from http://app.newsliquid.com/mcp):
   claude mcp add twitter -e OPENNEWS_TOKEN=<your-token> -- uv --directory <project-path> run twitter-mcp

できること

接続後、AI アシスタントにこう尋ねるだけです:

あなたの質問

実行内容

「@elonmusk の Twitter プロフィールを見せて」

ユーザープロフィール情報を取得

「@VitalikButerin の最近のツイートは?」

ユーザーの最近のツイートを取得

「Bitcoin 関連のツイートを検索して」

キーワード検索

「#crypto ハッシュタグのツイートを探して」

ハッシュタグ検索

「1000+ いいねの ETH に関する人気ツイート」

エンゲージメントフィルター検索

「@elonmusk をフォロワートラッキングで監視」

オプション付きで監視リストに追加

「このツイートを引用したのは誰?」

ツイートの引用ツイートを取得

「このツイートをリツイートしたのは誰?」

リツイートしたユーザーを取得

「最近 @elonmusk をフォローしたのは誰?」

新しいフォロワーイベントを取得

「@elonmusk のフォローを外したのは誰?」

フォロー解除イベントを取得

「@elonmusk が削除したツイートは?」

削除されたツイートを取得

「@elonmusk をフォローしている KOL は?」

KOL フォロワーを取得


利用可能なツール

ツール

説明

get_twitter_user

ユーザー名でユーザープロフィールを取得

get_twitter_user_by_id

数値 ID でユーザープロフィールを取得

get_twitter_user_tweets

ユーザーの最近のツイートを取得

search_twitter

基本フィルターでツイートを検索

search_twitter_advanced

複数フィルターによる高度な検索

get_twitter_follower_events

フォロー/フォロー解除イベントを取得

get_twitter_deleted_tweets

ユーザーの削除されたツイートを取得

get_twitter_kol_followers

KOL(キーオピニオンリーダー)フォロワーを取得

get_twitter_article_by_id

ID で Twitter 記事を取得

get_twitter_tweet_by_id

ネストされた返信/引用ツイート付きで ID によりツイートを取得

get_twitter_quote_tweets_by_id

特定のツイートを引用したツイートを取得

get_twitter_retweet_users_by_id

特定のツイートをリツイートしたユーザーを取得

get_twitter_watch

すべての Twitter 監視ユーザーを取得

add_twitter_watch

Twitter ユーザーを監視リストに追加(イベントタイプのオプション付き)

delete_twitter_watch

Twitter ユーザーを監視リストから削除


設定

API トークンの取得

http://app.newsliquid.com/mcp にアクセスして API トークンを取得してください。

環境変数を設定します:

# macOS / Linux
export OPENNEWS_TOKEN="<your-token>"

# Windows PowerShell
$env:OPENNEWS_TOKEN = "<your-token>"

変数

必須

説明

OPENNEWS_TOKEN

はい

6551 API ベアラートークン(http://app.newsliquid.com/mcp から取得)

TWITTER_API_BASE

いいえ

REST API URL の上書き

TWITTER_MAX_ROWS

いいえ

クエリあたりの最大結果数(デフォルト: 100)

プロジェクトルートの config.json にも対応しています(環境変数が優先されます):

{
  "api_base_url": "https://ai.6551.io",
  "api_token": "<your-token>",
  "max_rows": 100
}

WebSocket リアルタイムサブスクリプション

エンドポイント: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

監視中の Twitter アカウントからリアルタイムイベントを購読します。

ハートビート

接続を維持するために、クライアントは ping を送信でき、サーバーは pong で応答します。

Twitter イベントの購読

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "twitter.subscribe"
}

応答:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true
  }
}

購読解除

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "twitter.unsubscribe"
}

サーバープッシュ - Twitter イベント

監視中のアカウントにアクティビティがあると、サーバーがプッシュします:

{
  "jsonrpc": "2.0",
  "method": "twitter.event",
  "params": {
    "id": 123456,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "profileUrl": "https://twitter.com/elonmusk",
    "eventType": "NEW_TWEET",
    "content": "...",
    "ca": "0x1234...",
    "remark": "Custom note",
    "createdAt": "2026-03-06T10:00:00Z"
  }
}

注: content フィールドの構造はイベントタイプによって異なります(下記参照)。


**Event Types and Content Structure**:

#### Tweet Events
- `NEW_TWEET` - New tweet posted
- `NEW_TWEET_REPLY` - New reply tweet
- `NEW_TWEET_QUOTE` - New quote tweet
- `NEW_RETWEET` - Retweeted
- `CA` - Tweet with CA address

Content structure for tweet events:
```json
{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2026-03-06T10:00:00Z",
  "language": "en",
  "retweetCount": 100,
  "favoriteCount": 500,
  "replyCount": 20,
  "quoteCount": 10,
  "viewCount": 10000,
  "userScreenName": "elonmusk",
  "userName": "Elon Musk",
  "userIdStr": "44196397",
  "userFollowers": 170000000,
  "userVerified": true,
  "conversationId": "1234567890",
  "isReply": false,
  "isQuote": false,
  "hashtags": ["crypto", "bitcoin"],
  "media": [
    {
      "type": "photo",
      "url": "https://...",
      "thumbUrl": "https://..."
    }
  ],
  "urls": [
    {
      "url": "https://...",
      "expandedUrl": "https://...",
      "displayUrl": "example.com"
    }
  ],
  "mentions": [
    {
      "username": "VitalikButerin",
      "name": "Vitalik Buterin"
    }
  ]
}

フォロワーイベント

  • NEW_FOLLOWER - このアカウントがユーザーをフォローしました

  • NEW_UNFOLLOWER - このアカウントがユーザーのフォローを解除しました

フォロワーイベントのコンテンツ構造(配列):

[
  {
    "id": 123,
    "twId": 44196397,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "twUserLabel": "Verified",
    "description": "User bio...",
    "profileUrl": "https://...",
    "bannerUrl": "https://...",
    "followerCount": 170000000,
    "friendCount": 500,
    "createdAt": "2026-03-06T10:00:00Z"
  }
]

プロフィール更新イベント

  • UPDATE_NAME - ユーザー名が変更されました(content: 新しい名前の文字列)

  • UPDATE_DESCRIPTION - 自己紹介が更新されました(content: 新しい自己紹介の文字列)

  • UPDATE_AVATAR - プロフィール画像が変更されました(content: 新しいアバター URL の文字列)

  • UPDATE_BANNER - バナー画像が変更されました(content: 新しいバナー URL の文字列)

その他のイベント

  • TWEET_TOPPING - ツイートがピン留めされました

  • DELETE - ツイートが削除されました

  • SYSTEM - システムイベント

  • TRANSLATE - ツイートの翻訳

  • CA_CREATE - CA トークンが作成されました


データ構造

Twitter ユーザー

{
  "userId": "44196397",
  "screenName": "elonmusk",
  "name": "Elon Musk",
  "description": "...",
  "followersCount": 170000000,
  "friendsCount": 500,
  "statusesCount": 30000,
  "verified": true
}

ツイート

{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2024-02-20T12:00:00Z",
  "retweetCount": 1000,
  "favoriteCount": 5000,
  "replyCount": 200,
  "userScreenName": "elonmusk",
  "hashtags": ["crypto", "bitcoin"],
  "urls": [{"url": "https://..."}]
}

以下のすべての設定で、/path/to/twitter-mcp を実際のローカルプロジェクトパスに、<your-token> を http://app.newsliquid.com/mcp で取得したトークンに置き換えてください。

Claude Desktop

設定を編集します(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json、Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json または 設定 > MCP サーバー:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cline

VS Code サイドバー > Cline > MCP サーバー > 設定 で cline_mcp_settings.json を編集:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue.dev

~/.continue/config.yaml:

mcpServers:
  - name: twitter
    command: uv
    args:
      - --directory
      - /path/to/twitter-mcp
      - run
      - twitter-mcp
    env:
      OPENNEWS_TOKEN: <your-token>

Cherry Studio

設定 > MCP サーバー > 追加 > タイプ stdio: コマンド uv、引数 --directory /path/to/twitter-mcp run twitter-mcp、環境変数 OPENNEWS_TOKEN。

Zed Editor

~/.config/zed/settings.json:

{
  "context_servers": {
    "twitter": {
      "command": {
        "path": "uv",
        "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
        "env": {
          "OPENNEWS_TOKEN": "<your-token>"
        }
      }
    }
  }
}

任意の stdio MCP クライアント

OPENNEWS_TOKEN=<your-token> \
  uv --directory /path/to/twitter-mcp run twitter-mcp

互換性

クライアント

インストール方法

ステータス

Claude Code

claude mcp add

ワンライナー

OpenClaw

スキルディレクトリをコピー

ワンライナー

Claude Desktop

JSON 設定

対応済み

Cursor

JSON 設定

対応済み

Windsurf

JSON 設定

対応済み

Cline

JSON 設定

対応済み

Continue.dev

YAML / JSON

対応済み

Cherry Studio

GUI

対応済み

Zed

JSON 設定

対応済み


開発

cd /path/to/twitter-mcp
uv sync
uv run twitter-mcp
# MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/twitter-mcp run twitter-mcp

プロジェクト構造

├── README.md
├── docs/
│   ├── README_JA.md           # 日本語
│   └── README_KO.md           # 한국어
├── openclaw-skill/opentwitter/    # OpenClaw Skill
├── pyproject.toml
├── config.json
└── src/twitter_mcp/
    ├── server.py              # Entry point
    ├── app.py                 # FastMCP instance
    ├── config.py              # Config loader
    ├── api_client.py          # HTTP client
    └── tools.py               # 8 tools

ライセンス

MIT

Available Tools

12 tools
add_twitter_watchB

Add a Twitter user to monitoring list.

Args: username: Twitter username to monitor (without @).

Inputs: username (required).

delete_twitter_watchC

Delete a Twitter user from monitoring list.

Args: watch_id: The monitoring record ID to delete.

Inputs: watch_id (required).

get_twitter_article_by_idC

Get Twitter article by ID.

Args: article_id: Twitter article ID.

Inputs: article_id (required).

get_twitter_deleted_tweetsB

Get deleted tweets from a Twitter/X user.

Args: username: Twitter username (without @). limit: Maximum tweets to return (default 20, max 100).

Inputs: username (required), limit.

get_twitter_follower_eventsB

Get follower/unfollower events for a Twitter/X user.

Args: username: Twitter username (without @). is_follow: True for new followers, False for unfollowers. limit: Maximum events to return (default 20, max 100).

Inputs: username (required), is_follow, limit.

get_twitter_kol_followersC

Get KOL (Key Opinion Leader) followers for a Twitter/X user.

Returns which influential accounts (KOLs) are following this user.

Args: username: Twitter username (without @).

Inputs: username (required).

get_twitter_userA

Get Twitter/X user profile information by username.

Args: username: Twitter username (without @, e.g. "elonmusk").

Inputs: username (required).

get_twitter_user_by_idB

Get Twitter/X user profile information by user ID.

Args: user_id: Twitter user ID (numeric string).

Inputs: user_id (required).

get_twitter_user_tweetsA

Get recent tweets from a specific Twitter/X user.

Args: username: Twitter username (without @). limit: Maximum tweets to return (default 20, max 100). include_replies: Include reply tweets (default False). include_retweets: Include retweets (default False).

Inputs: username (required), limit, include_replies, include_retweets.

get_twitter_watchB

Get all Twitter monitoring users for the current user.

Returns a list of Twitter accounts being monitored.

Inputs: no named parameters.

search_twitterA

Search Twitter/X for tweets matching criteria.

Args: keywords: Search keywords. from_user: Filter tweets from specific user (without @). hashtag: Filter by hashtag (without #). min_likes: Minimum likes threshold. limit: Maximum tweets to return (default 20, max 100).

Inputs: keywords, from_user, hashtag, min_likes, +1 more.

search_twitter_advancedB

Advanced Twitter/X search with multiple filters.

Args: keywords: Search keywords. from_user: Filter tweets from specific user. to_user: Filter tweets to specific user. mention_user: Filter tweets mentioning specific user. hashtag: Filter by hashtag (without #). exclude_replies: Exclude reply tweets. exclude_retweets: Exclude retweets. min_likes: Minimum likes threshold. min_retweets: Minimum retweets threshold. min_replies: Minimum replies threshold. since_date: Start date (YYYY-MM-DD). until_date: End date (YYYY-MM-DD). lang: Language code (e.g. "en", "zh"). product: Sort by "Top" or "Latest" (default "Top"). limit: Maximum tweets to return (default 20, max 100).

Inputs: keywords, from_user, to_user, mention_user, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between get_twitter_user and get_twitter_user_by_id (both retrieve user profiles via different identifiers) and between search_twitter and search_twitter_advanced (both search tweets, with the latter being a superset). The descriptions clarify the differences, preventing major confusion.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., add_twitter_watch, get_twitter_user_tweets, search_twitter_advanced). The naming is predictable and uniform across all 12 tools.

    Tool Count5/5

    With 12 tools, the server is well-scoped for Twitter/X monitoring and data retrieval. The count is appropriate, covering user management, tweet fetching, search, and monitoring without being overwhelming or insufficient for the domain.

    Completeness4/5

    The toolset provides strong coverage for monitoring and retrieving Twitter data, including user profiles, tweets, searches, and follower events. Minor gaps exist, such as no tools for posting tweets or interacting with tweets (e.g., liking, retweeting), but core retrieval and monitoring workflows are well-covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables complete management of X (Twitter) accounts through a single API key, supporting functions like getting tweets, searching, generating and posting replies.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with X (Twitter) to post tweets, threads, and replies while retrieving tweet metrics and account information. It supports core management tasks like deleting tweets and verifying authentication through the Twitter API.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to access Twitter/X data including user profiles, tweets, search, and follower events via a set of MCP tools.
      MIT