Skip to main content
Glama
X Search MCP Server

X Search MCP Server

by phiclin

X Search MCP Server

让 Claude Code 搜索 X (Twitter) 实时内容的 MCP Server。

功能

  • search_x — 搜索 X 上的帖子、讨论、趋势

  • search_web_via_grok — 通过 Grok 搜索网页

  • search_combined — 同时搜索 X 和网页

Related MCP server: Grok MCP Server

快速开始

1. 获取 xAI API Key

访问 https://console.x.ai 注册,新用户送 $25 免费额度。

2. 克隆项目

git clone https://github.com/your-repo/x-search-mcp.git
cd x-search-mcp

3. 安装依赖

npm install
npm run build

4. 配置环境变量

创建 .env 文件:

XAI_API_KEY=your-api-key-here

5. 配置 Claude Code

将以下配置添加到 ~/.claude/settings.local.json:

{
  "mcpServers": {
    "x-search": {
      "command": "node",
      "args": ["x-search-mcp/build/index.js"],
      "env": {
        "XAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

6. 重启 Claude Code

重启后,你就可以直接让 Claude 搜索 X 上的内容了:

"搜一下 X 上关于 Claude Code 的最新讨论"

费用说明

  • 每次 X 搜索约消耗 5000-7000 tokens ≈ $0.001-0.003

  • 新用户 $25 免费额度足够搜索数千次

  • 可通过数据共享计划获得 $150/月额外免费额度

项目结构

x-search-mcp/
├── src/
│   └── index.ts      # 源码
├── build/
│   └── index.js      # 编译产物
├── package.json
├── tsconfig.json
└── README.md

技术栈

  • TypeScript

  • @modelcontextprotocol/sdk

  • xAI Grok API

License

MIT

Available Tools

3 tools
search_combinedB

Search both X (Twitter) and the web simultaneously for comprehensive results. Grok will automatically decide which source to use or combine both. Best for getting a complete picture of a topic from social media AND web sources.

Inputs: query (required), to_date, from_date.

search_web_via_grokA

Search the web for real-time information via Grok. Returns summarized results from web pages. Useful for current events, documentation, news, and general knowledge.

Inputs: query (required), allowed_domains.

search_xA

Search X (Twitter) for real-time posts, discussions, and trends on any topic. Powered by Grok's x_search, returns summarized results with original quotes from users. Supports filtering by date range and specific X handles.

Inputs: query (required), to_date, from_date, x_handles.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation3/5

    search_x and search_web_via_grok clearly target distinct sources, but search_combined is a superset of both, so an agent may reasonably wonder why it would ever pick the narrower tools. The descriptions do clarify intent, keeping them mostly distinguishable.

    Naming Consistency4/5

    All three share the search_ prefix, which is good, but the suffixes vary in style (search_x, search_web_via_grok, search_combined) rather than following one predictable pattern. Still readable and mostly consistent.

    Tool Count3/5

    Three tools is on the thin side for a search server, and one of them (search_combined) arguably subsumes the other two, making the surface feel slightly redundant rather than lean.

    Completeness4/5

    The core search domain is covered across X, web, and combined sources, but finer operations like thread retrieval, user/timeline lookup, or pagination are absent. Minor gaps an agent can work around.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables real-time search of X.com (Twitter) posts, users, threads, and trends via xAI's Grok API, directly from Claude.
      5
      42 PyPI
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time web and Twitter/X search via Grok, returning structured results with source URLs, confidence scores, and key points. Supports multiple output modes, language options, and time range filtering.
      1,028 npm
      4
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables real-time search of X (Twitter) posts, user timelines, and trends using either xAI's Responses API or the official X API v2.
      4
      -