# X Search MCP Server

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

## 功能

- **search_x** — 搜索 X 上的帖子、讨论、趋势
- **search_web_via_grok** — 通过 Grok 搜索网页
- **search_combined** — 同时搜索 X 和网页

## 快速开始

### 1. 获取 xAI API Key

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

### 2. 克隆项目

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

### 3. 安装依赖

```bash
npm install
npm run build
```

### 4. 配置环境变量

创建 `.env` 文件：

```
XAI_API_KEY=your-api-key-here
```

### 5. 配置 Claude Code

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

```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