X (Twitter) Search MCP Server
MCP 対応クライアントから X (Twitter) の投稿をリアルタイム検索できる MCP サーバーです。2 つのデータ源 backend を選べます:
- xAI backend — Responses API + x_search サーバーサイドツール。Grok が自律的に X を検索・分析(セマンティック検索)。
- xurl backend — 公式 CLI 経由の認証済み実 X API v2。生のポストデータを直接取得。
Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatYayıncıdan
MCP 対応クライアントから X (Twitter) の投稿をリアルタイム検索できる MCP サーバーです。2 つのデータ源 backend を選べます:
X (Twitter) Search MCP Server using xAI Grok API for Claude Desktop
backend は環境変数 X_SEARCH_BACKEND で切り替えます(既定 auto)。
X_SEARCH_BACKEND)XAI_API_KEY が必要です。xurl CLI が PATH 上にあり OAuth2 認証済み(xurl auth)であることが必要です。auto で xurl が利用できない環境では自動的に xAI にフォールバックするため、どちらか一方だけの構成でも動作します。x_get_trending は xurl に安定したトレンド API が無いため常に xAI backend を使用します。stdio トランスポートに対応した MCP クライアントであれば利用できます。代表的なものを以下に挙げます:
その他の MCP 対応クライアントは MCP Clients 一覧 を参照してください。
xurl CLI( https://github.com/xdevplatform/xurl )を導入し xurl auth で認証 — xurl backend を使う場合いずれか一方だけでも動作します。両方を用意して
X_SEARCH_BACKEND=auto(既定)にすると、xurl 優先・xAI フォールバックになります。
git clone https://github.com/toocheap/x-search-mcp.git
cd x-search-mcp
# 仮想環境を作成
python3 -m venv .venv
# 仮想環境を有効化
# macOS / Linux:
source .venv/bin/activate
# Windows:
# .venv\Scripts\activate
# 依存パッケージをインストール
pip install -r requirements.txt
MCP クライアントの設定にはフルパスが必要です。以下のコマンドで確認してください:
# macOS / Linux(venv を有効化した状態で)
which python3
# 例: /Users/yourname/src/x-search-mcp/.venv/bin/python3
# Windows
# where python
# 例: C:\Users\yourname\src\x-search-mcp\.venv\Scripts\python.exe
ほとんどの MCP クライアントは同じ JSON 形式の設定に対応しています。 以下の内容をお使いのクライアントの MCP 設定に追加してください:
{
"mcpServers": {
"x_search": {
"command": "/absolute/path/to/x-search-mcp/.venv/bin/python3",
"args": ["/absolute/path/to/x-search-mcp/x_search_mcp.py"],
"env": {
"XAI_API_KEY": "xai-xxxxxxxxxxxxxxxxxxxxxxxx",
"X_SEARCH_BACKEND": "auto"
}
}
}
}
重要:
commandには 手順2で確認した仮想環境の Python フルパスを指定してください。システムのpython3ではなく.venv内のものを使います。argsにはx_search_mcp.pyの絶対パスを指定してください。XAI_API_KEYには https://console.x.ai/ で取得した API キーを設定してください(xAI backend 用)。X_SEARCH_BACKENDはauto(既定)/xurl/xaiから選びます。省略時はauto。xurl backend は MCP サーバーを起動するユーザーのxurl認証情報(~/.xurl)を使うため、envに資格情報を書く必要はありません。
設定を保存したらクライアントを再起動してください。MCP サーバーが認識され、X 検索ツールが使えるようになります。
MCP クライアントで以下のように話しかけるだけです:
┌─ (xai) xAI Responses API (/v1/responses) ─ x_search tool ─┐
MCP Client <-> MCP Server ┤ ├─> X (Twitter) data
(stdio) └─ (xurl) xurl CLI ─ X API v2 (/2/tweets/search/recent 等) ──┘
search_parameters) は 2026年1月に廃止されたため、新しい Agent Tools API を使用しています。xurl CLI 経由で認証済みの X API v2 エンドポイント(/2/tweets/search/recent, /2/users/:id/tweets 等)を直接呼び出し、生のポストを取得します。アダプタは xurl_client.py に実装されています。x_search サーバーサイドツールは grok-4 系モデルのみで利用可能です。
モデルを変更する場合は x_search_mcp.py 内の XAI_MODEL 定数を編集してください。
注意:
grok-3系モデルでは x_search ツールは利用できません(400 エラーになります)。
x_auth_status ツールを呼ぶと、現在有効な backend と xurl の認証状態を確認できます。
Claude Desktop の場合、ログは以下で確認できます:
# macOS
cat ~/Library/Logs/Claude/mcp-server-x_search.log
xAI API の利用料金が発生します。詳細は xAI Pricing を参照してください。
MIT
X (Twitter) Search MCP Server using xAI Grok API for Claude Desktop
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
X Search yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-10-27. X (Twitter) Search MCP Server using xAI Grok API for Claude Desktop