x-quick-mcp-server

xAI Responses API を使って X（旧Twitter）の投稿をリアルタイム検索する MCP サーバー。

Claude.ai / Claude Code / Claude Desktop から npx で実行できます。

セットアップ

1. xAI API キーの取得

xAI Console でアカウントを作成し、APIキーを取得してください。

2. Claude.ai での設定

Claude.ai の Settings → MCP Servers に以下を追加：

{
  "mcpServers": {
    "x-quick": {
      "command": "npx",
      "args": ["-y", "x-quick-mcp-server"],
      "env": {
        "XAI_API_KEY": "xai-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop での設定

claude_desktop_config.json に追加：

{
  "mcpServers": {
    "x-quick": {
      "command": "npx",
      "args": ["-y", "x-quick-mcp-server"],
      "env": {
        "XAI_API_KEY": "xai-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code での設定

claude mcp add x-quick -e XAI_API_KEY=xai-xxx -- npx -y x-quick-mcp-server

APIキーの管理

環境変数 XAI_API_KEY で管理します（MCP設定の env フィールドで渡す）。

ウォッチリストのカスタマイズなど追加設定が必要な場合は、~/.config/x-quick-mcp/config.json を作成することもできます（環境変数のAPIキーが常に優先）：

{
  "default_model": "grok-4-1-fast",
  "watchlist_handles": [
    "ai_biostat",
    "_daichikonno",
    "ctgptlb",
    "nukonuko",
    "usutaku_channel",
    "masahirochaen",
    "karaage0703"
  ],
  "default_watchlist_period": "24h",
  "default_weekly_topic": "医療AI・内視鏡AI・消化器内科AI・生成AI全般",
  "store_conversations": false
}

ツール一覧

x_search — 汎用X検索

X の投稿をリアルタイムで検索します。

| パラメータ | 型 | 必須 | 説明 | |-----------|---|------|------| | query | string | ✅ | 自然言語の検索クエリ | | allowed_handles | string[] | - | 指定ユーザーのみ検索（@なし、最大10件） | | excluded_handles | string[] | - | 指定ユーザーを除外（@なし、最大10件） | | from_date | string | - | 開始日（YYYY-MM-DD） | | to_date | string | - | 終了日（YYYY-MM-DD） | | model | string | - | 使用モデル（grok-4-1-fast / grok-4-1-fast-reasoning / grok-4） | | include_web_search | boolean | - | Web検索も併用するか |

x_watchlist — ウォッチリスト検索

デフォルトの医療AI関連アカウントの最新投稿を取得・要約します。

| パラメータ | 型 | 必須 | 説明 | |-----------|---|------|------| | period | string | - | 検索期間（24h / 3d / 1w） | | extra_handles | string[] | - | 追加で含めるハンドル |

x_weekly — 週次トレンドレポート

過去7日間のXの投稿から、指定トピックのトレンドを週次レポート形式でまとめます。

| パラメータ | 型 | 必須 | 説明 | |-----------|---|------|------| | topic | string | - | 対象トピック（デフォルト: 医療AI・内視鏡AI・消化器内科AI・生成AI全般） | | model | string | - | 使用モデル（デフォルト: grok-4-1-fast-reasoning） |

ローカル開発

git clone https://github.com/your-repo/x-quick-mcp-server.git
cd x-quick-mcp-server
npm install
npm run build
node dist/index.js

注意事項

• xAI API は従量課金制です（https://docs.x.ai/developers/models）
• レート制限があります（https://docs.x.ai/developers/rate-limits）
• x_weekly は grok-4-1-fast-reasoning を使用するため、応答に最大3分かかる場合があります
• 会話の保存を無効にするには store_conversations: false（デフォルト）

ライセンス

MIT