Grok X Search MCP

grok-x-search-mcp

免费、开源 模型上下文协议（MCP） 服务器，让克劳德通过实时访问X（推特） xAI Grok API.搜索帖子、分析情绪、跟踪账户以及将X与网络资源进行交叉引用——所有这些都来自克劳德。

免费使用。 此MCP服务器是开源的，不收取任何费用。你只需支付 xAI直接 API使用-大致 每次搜索0.005-0.01美元.

______________________________________________________________________

为什么不直接使用X API？

传统的X（Twitter）API对大多数开发人员来说已经变得昂贵得令人望而却步：

除此之外，X API还需要开发人员应用程序批准流程、OAuth设置和仔细的费率限制管理。

使用此MCP服务器，你跳过所有这些。Grok的 x_search 该工具具有对内置的X个帖子和线程的特权实时访问。一个xAI API密钥，一个 npm install，几分钟后你就可以通过克劳德询问X了。

______________________________________________________________________

工具

______________________________________________________________________

先决条件

• Node.js >= 22
• 克劳德桌面版 或任何MCP兼容客户端
• xAI API密钥 --得到一个在 console.x.ai

______________________________________________________________________

设置

1.克隆并安装

git clone https://github.com/0xnicholasy/grok-x-search-mcp.git
cd grok-x-search-mcp
npm install

2.配置环境

cp .env.example .env

编辑 .env 并设置您的API密钥：

XAI_API_KEY=xai-your-api-key-here
GROK_MODEL=grok-4-1-fast
MAX_RETRIES=3
REQUEST_TIMEOUT_MS=45000
LOG_LEVEL=info

3.建造

npm run build

4.向Claude注册

克劳德桌面版 --添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "grok-x-search": {
      "command": "node",
      "args": ["/absolute/path/to/grok-x-search-mcp/dist/server.js"]
    }
  }
}

克劳德代码（CLI） --运行一次：

claude mcp add --scope user grok-x-search node /absolute/path/to/grok-x-search-mcp/dist/server.js

Cursor/Windsurf/其他MCP客户端 --添加到您的MCP配置中：

{
  "mcpServers": {
    "grok-x-search": {
      "command": "node",
      "args": ["/absolute/path/to/grok-x-search-mcp/dist/server.js"]
    }
  }
}

注册后重新启动客户端。用验证 /mcp （克劳德桌面）或 claude mcp list （克劳德代码CLI）。

______________________________________________________________________

使用示例

注册后，只需与克劳德交谈：

Search X for what people are saying about NVIDIA earnings this week

What is the X sentiment on Bitcoin today? Show me verbatim posts.

Track @sama's posts this week — what topics is he focused on?

Fact-check: is the claim that "inflation is rising" on X supported by web sources?

Monitor X for "GPT-5" — I'll call this again later to see new posts

______________________________________________________________________

API 成本

此MCP服务器是 免费和开源。唯一的费用是xAI API费用，直接计入您的账户：

典型的 search_x 通话费用大致 $0.005–$0.01 总计。新的xAI帐户获得 $25免费积分 开始。

将其与每月最低200美元的X API基本层进行比较——只是为了获得读取访问权限。

______________________________________________________________________

配置

选择模型

grok-4-1-fast 是推荐的默认值——它既是最便宜的文本模型，又提供grok-4质量。主要成本是 x_search 工具调用（每次调用0.005美元），而不是令牌。

为了达到最高的精度使用 grok-4-0709，但预计代币成本将增加30倍。

______________________________________________________________________

发展

# Run with hot-reload (no build needed)
npm run dev

# Interactive tool inspector
npm run inspect

# Run unit tests
npm run test:unit

# Run all tests (requires XAI_API_KEY in .env for integration tests)
npm test

# Type-check without building
npm run lint

这 monitor_x 工具将状态持久化到 .monitor-state.json 在项目根目录中（从git中排除）。删除此文件以重置所有监控历史记录。

______________________________________________________________________

项目结构

src/
  server.ts             # MCP server — tool definitions and request handlers
  grokClient.ts         # xAI Responses API client with retry + timeout
  sentimentAnalyzer.ts  # Prompt builder and response parser for search_x
  monitorState.ts       # State persistence and post deduplication for monitor_x
  config.ts             # Environment config with Zod validation
  types.ts              # Zod schemas and TypeScript types
  utils.ts              # Date range helpers
  __tests__/
    unit/               # Unit tests (no API key needed)
    integration/        # Integration tests (requires XAI_API_KEY)

______________________________________________________________________

许可证

麻省理工学院