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。生のポストデータを直接取得。
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
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.
AbrirDo publicador
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
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
X Search roda localmente via stdio.
Última verificação: 2026-10-27. X (Twitter) Search MCP Server using xAI Grok API for Claude Desktop