Grok MCP

🚀 Grok MCP Server

xAIのGrok APIを使用して、Claudeから直接X.comをリアルタイムで検索できます。

Model Context Protocolサーバーで、ClaudeにリアルタイムのX/Twitter検索機能を提供します。xAIのLive Search APIを活用し、投稿、ユーザー、スレッド、トレンドトピックに即座にアクセスできます。

🚀 クイックスタート

1. xAI APIキーを取得する

console.x.aiからAPIキーを取得します。

2. インストール

uvx grok-mcp

3. Claudeを設定する

Claude Codeの場合 - プロジェクト内の.mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "grok": {
      "command": "uvx",
      "args": ["grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktopの場合 - 設定ファイルに以下を追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "grok": {
      "command": "uvx",
      "args": ["grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-api-key"
      }
    }
  }
}

4. 使用する

Claudeに以下のような質問をします。

• "AIに関する投稿をXで検索して"
• "現在Xでトレンドになっていることは何ですか？"
• "@elonmuskからTeslaに関するツイートを見つけて"

✨ 主な機能

• リアルタイムデータ - キャッシュや古い情報ではなく、X.comの最新のコンテンツにアクセスできます。
• Claudeとのネイティブ統合 - Claude DesktopとClaude Codeとシームレスに連携します。
• 簡単なセットアップ - 1つのコマンドでインストールし、1つの設定を追加するだけです。
• オープンソース - MITライセンスで、コミュニティ主導で開発されています。

📦 インストール

uvx grok-mcp

💻 使用例

基本的な使用法

Search X for posts about "AI safety" from the last week

高度な使用法

Find recent posts from @anthropic about Claude

What are the trending topics in tech right now?

📚 詳細ドキュメント

利用可能なツール

🔧 技術詳細

アーキテクチャ

src/grok_mcp/
├── server.py           # MCPサーバーの実装
├── grok_client.py      # xAI Live Search APIクライアント
├── search_tools.py     # ツールの実装
├── response_formatter.py
├── config.py
└── exceptions.py

開発手順

# クローン
git clone https://github.com/guzus/grok-mcp.git
cd grok-mcp

# 依存関係のインストール
uv sync --dev

# テストの実行
uv run pytest

# ローカルで実行
XAI_API_KEY=your-key uv run python -m grok_mcp

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. 新しいフィーチャーブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

🔗 リンク

• PyPIパッケージ
• xAI APIドキュメント
• MCPプロトコル
• Claude Code

Built with xAI Grok and Model Context Protocol