内容
# x-mcp
一个最小化、无依赖的MCP服务器，用于X（Twitter）API v2。由于现有的服务器都已损坏，因此构建了此服务器。
## 为什么
我们尝试了流行的Twitter MCP服务器。它们都在Claude Code中由于输出模式验证错误而失败。因此，我们构建了一个可用的服务器——零外部依赖，纯标准库 + MCP SDK。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `get_me` | 身份验证用户配置文件 |
| `get_user_profile` | 通过用户名获取公共配置文件 |
| `post_tweet` | 发布推文（可选回复） |
| `search_tweets` | 搜索最近的推文 |
| `get_user_tweets` | 用户最近的推文 |
| `get_timeline` | 首页时间线（逆时间顺序） |
| `delete_tweet` | 通过ID删除推文 |
## 设置
### 1. 获取X API凭证
前往 [console.x.com](https://console.x.com)，创建项目和应用，权限设置为 **读取和写入**，生成OAuth 1.0a凭证。
您需要四个值：
- API密钥（消费者密钥）
- API密钥秘密（消费者秘密）
- 访问令牌（格式：`123456789-AbCdEf...`）
- 访问令牌秘密
### 2. 在Claude Code中注册
```bash
claude mcp add twitter \
-e API_KEY=您的_api_key \
-e API_SECRET_KEY=您的_api_secret \
-e ACCESS_TOKEN=您的_access_token \
-e ACCESS_TOKEN_SECRET=您的_access_token_secret \
-s user -- python3 /path/to/x-mcp/server.py
```
### 3. 重启Claude Code
七种工具将自动出现。无需凭证以外的配置。
## 要求
- Python 3.9+
- `mcp` 包（`pip install mcp`）
- X API按使用量计费层级（最低5美元信用，无需订阅）
## 多个账户
使用不同的凭证为每个账户注册相同的服务器：
```bash
claude mcp add twitter-personal -e API_KEY=... -- python3 server.py
claude mcp add twitter-brand -e API_KEY=... -- python3 server.py
```
## 许可证
MIT — [The Funkatorium](https://funkatorium.com)
