JinDaGe - grok-mcp MCP Details

article

README

🚀 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的帖子

获取热门话题

现在科技领域的热门话题有哪些？

📚 详细文档

可用工具

| 工具 | 描述 | |------|-------------| | search_posts | 使用过滤器（用户名、日期范围、分析模式）搜索帖子 | | search_users | 查找用户资料 | | search_threads | 发现对话话题串 | | get_trends | 按地点获取热门话题 | | health_check | 验证API连接 |

项目架构

src/grok_mcp/
├── server.py           # MCP服务器实现
├── grok_client.py      # xAI实时搜索API客户端
├── search_tools.py     # 工具实现
├── response_formatter.py
├── config.py
└── exceptions.py

🤝 贡献代码

欢迎贡献代码！请随时提交拉取请求。

分叉仓库
创建你的功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m '添加出色的功能')
推送到分支 (git push origin feature/amazing-feature)
打开拉取请求

📄 许可证

本项目采用MIT许可协议 - 详情请参阅 LICENSE 文件。

🔗 相关链接

由 xAI Grok 和模型上下文协议构建

grok-mcp