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 和 模型上下文协议 构建