Grok MCP

🚀 Grok MCP Server

藉助xAI的Grok API，直接從Claude實現對X.com的即時搜索

這是一個 模型上下文協議 服務器，它為Claude帶來了即時X/Twitter搜索功能。該服務器由xAI的即時搜索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提問，例如：

• "在X上搜索關於AI的帖子"
• "X上現在的熱門話題是什麼？"
• "查找@elonmusk關於特斯拉的推文"

✨ 主要特性

• 即時數據 - 訪問X.com的即時內容，而非緩存或過時信息。
• 原生Claude集成 - 與Claude Desktop和Claude Code無縫協作。
• 簡單設置 - 一條命令完成安裝，添加一個配置即可使用。
• 開源 - 採用MIT許可協議，由社區驅動開發。

📦 安裝指南

開發環境安裝

# 克隆倉庫
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

💻 使用示例

搜索帖子

在X上搜索上週關於“AI安全”的帖子

按用戶過濾

查找@anthropic最近關於Claude的帖子

獲取熱門話題

現在科技領域的熱門話題有哪些？

📚 詳細文檔

可用工具

項目架構

src/grok_mcp/
├── server.py           # MCP服務器實現
├── grok_client.py      # xAI即時搜索API客戶端
├── search_tools.py     # 工具實現
├── response_formatter.py
├── config.py
└── exceptions.py

🤝 貢獻代碼

歡迎貢獻代碼！請隨時提交拉取請求。

1. 分叉倉庫
2. 創建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加出色的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

📄 許可證

本項目採用MIT許可協議 - 詳情請參閱 LICENSE 文件。

🔗 相關鏈接

• PyPI軟件包
• xAI API文檔
• MCP協議
• Claude Code

由 xAI Grok 和 模型上下文協議 構建