Opentwitter MCP

Twitter MCP Server

Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking

中文 | 日本語 | 한국어

______________________________________________________________________

快速安装

首先，转到 https://6551.io/mcp 获取您的API代币。

克劳德代码

claude mcp add twitter \
  -e TWITTER_TOKEN= \
  -- uv --directory /path/to/twitter-mcp run twitter-mcp

替换 /path/to/twitter-mcp 使用您当地的项目路径，以及 `` 用你的代币。

开爪

export TWITTER_TOKEN=""
cp -r openclaw-skill/opentwitter ~/.openclaw/skills/

______________________________________________________________________

让AI为您审查和安装

不确定此MCP是否安全？将下面的提示粘贴到您的AI助手上——它将首先检查源代码，然后在安全的情况下进行安装：

**复制此提示并将其发送给您的AI助手（替换 `

和 ` 实际值）：**

Please review and install the twitter-mcp MCP server for me. The project is at 
.

Steps:
1. Review these files for security:
   - src/twitter_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
   - src/twitter_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
   - src/twitter_mcp/tools.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
   - pyproject.toml — Confirm dependencies are only mcp, httpx, no suspicious packages
2. Tell me your conclusion: safe / risky / problematic, with specific reasons
3. If safe, run the install (get Token from https://6551.io/mcp):
   claude mcp add twitter -e TWITTER_TOKEN= -- uv --directory 
 run twitter-mcp

______________________________________________________________________

它能做什么？

连接后，只需询问您的AI助手：

______________________________________________________________________

可用工具

______________________________________________________________________

配置

获取API令牌

首选 https://6551.io/mcp 获取您的API代币。

设置环境变量：

# macOS / Linux
export TWITTER_TOKEN=""

# Windows PowerShell
$env:TWITTER_TOKEN = ""

还支持 config.json 在项目根目录中（环境变量优先）：

{
  "api_base_url": "https://ai.6551.io",
  "api_token": "",
  "max_rows": 100
}

______________________________________________________________________

WebSocket实时订阅

端点: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

从您监控的推特帐户订阅实时事件。

订阅推特活动

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "twitter.subscribe"
}

回应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true
  }
}

退订

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "twitter.unsubscribe"
}

服务器推送-推特事件

当被监控的帐户有活动时，服务器会推送：

{
  "jsonrpc": "2.0",
  "method": "twitter.event",
  "params": {
    "id": 123456,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "profileUrl": "https://twitter.com/elonmusk",
    "eventType": "NEW_TWEET",
    "content": "...",
    "ca": "0x1234...",
    "remark": "Custom note",
    "createdAt": "2026-03-06T10:00:00Z"
  }
}

备注：The content 字段结构因事件类型而异（见下文）。

**Event Types and Content Structure**:

#### Tweet Events
- `NEW_TWEET` - New tweet posted
- `NEW_TWEET_REPLY` - New reply tweet
- `NEW_TWEET_QUOTE` - New quote tweet
- `NEW_RETWEET` - Retweeted
- `CA` - Tweet with CA address

Content structure for tweet events:

{ "id": "1234567890", "text": "Tweet content...", "createdAt": "2026-03-06T10:00:00Z", "language": "en", "retweetCount": 100, "favoriteCount": 500, "replyCount": 20, "quoteCount": 10, "viewCount": 10000, "userScreenName": "elonmusk", "userName": "Elon Musk", "userIdStr": "44196397", "userFollowers": 170000000, "userVerified": true, "conversationId": "1234567890", "isReply": false, "isQuote": false, "hashtags": ["crypto", "bitcoin"], "media": [ { "type": "photo", "url": "https://...", "thumbUrl": "https://..." } ], "urls": [ { "url": "https://...", "expandedUrl": "https://...", "displayUrl": "example.com" } ], "mentions": [ { "username": "VitalikButerin", "name": "Vitalik Buterin" } ] }

#### 关注者活动

- `NEW_FOLLOWER` -新追随者
- `NEW_UNFOLLOWER` -取消关注事件

关注者事件的内容结构（数组）：

[ { "id": 123, "twId": 44196397, "twAccount": "elonmusk", "twUserName": "Elon Musk", "twUserLabel": "Verified", "description": "User bio...", "profileUrl": "https://...", "bannerUrl": "https://...", "followerCount": 170000000, "friendCount": 500, "createdAt": "2026-03-06T10:00:00Z" } ]

#### 个人资料更新事件

- `UPDATE_NAME` -用户名已更改（内容：新名称字符串）
- `UPDATE_DESCRIPTION` -生物更新（内容：新描述字符串）
- `UPDATE_AVATAR` -个人资料图片已更改（内容：新头像URL字符串）
- `UPDATE_BANNER` -横幅图像已更改（内容：新的横幅URL字符串）

#### 其他事件

- `TWEET_TOPPING` -推特已固定
- `DELETE` -推特已删除
- `SYSTEM` -系统事件
- `TRANSLATE` -推特翻译
- `CA_CREATE` -CA令牌已创建

______________________________________________________________________

## 数据结构

### 推特用户

{ "userId": "44196397", "screenName": "elonmusk", "name": "Elon Musk", "description": "...", "followersCount": 170000000, "friendsCount": 500, "statusesCount": 30000, "verified": true }

### 推文

{ "id": "1234567890", "text": "Tweet content...", "createdAt": "2024-02-20T12:00:00Z", "retweetCount": 1000, "favoriteCount": 5000, "replyCount": 200, "userScreenName": "elonmusk", "hashtags": ["crypto", "bitcoin"], "urls": [{"url": "https://..."}] }

______________________________________________________________________

Other Clients — Manual Install (click to expand)

> 在以下所有配置中，更换 `/path/to/twitter-mcp` 使用您的实际本地项目路径，以及 `` 使用您的令牌 [https://6551.io/mcp](https://6551.io/mcp).

### 克劳德桌面版

编辑配置（macOS： `~/Library/Application Support/Claude/claude_desktop_config.json`，Windows： `%APPDATA%\Claude\claude_desktop_config.json`):

{ "mcpServers": { "twitter": { "command": "uv", "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"], "env": { "TWITTER_TOKEN": "" } } } }

### 光标

`~/.cursor/mcp.json` 或设置>MCP服务器：

{ "mcpServers": { "twitter": { "command": "uv", "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"], "env": { "TWITTER_TOKEN": "" } } } }

### 帆板运动

`~/.codeium/windsurf/mcp_config.json`:

{ "mcpServers": { "twitter": { "command": "uv", "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"], "env": { "TWITTER_TOKEN": "" } } } }

### 克莱恩

VS代码侧栏>临床>MCP服务器>配置、编辑 `cline_mcp_settings.json`:

{ "mcpServers": { "twitter": { "command": "uv", "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"], "env": { "TWITTER_TOKEN": "" }, "disabled": false, "autoApprove": [] } } }

### Continue.dev

`~/.continue/config.yaml`:

mcpServers: - name: twitter command: uv args: - --directory - /path/to/twitter-mcp - run - twitter-mcp env: TWITTER_TOKEN:

### 樱桃工作室

设置>MCP服务器>添加>键入stdio：命令 `uv`，Args `--directory /path/to/twitter-mcp run twitter-mcp`，Env `TWITTER_TOKEN`.

### 泽德编辑器

`~/.config/zed/settings.json`:

{ "context_servers": { "twitter": { "command": { "path": "uv", "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"], "env": { "TWITTER_TOKEN": "" } } } } }

### 任何stdio MCP客户端

TWITTER_TOKEN= \ uv --directory /path/to/twitter-mcp run twitter-mcp

______________________________________________________________________

## 兼容性

|客户端|安装方法|状态|
|--------|---------------|--------|
| **克劳德代码** | `claude mcp add` |一个衬垫|
| **开爪** |复制技能目录|单行|
|Claude桌面| JSON配置|支持|
|游标|JSON配置|支持|
|Windsurf | JSON配置|支持|
|Cline|JSON配置|支持|
|Continue.dev | YAML/JSON |支持|
|Cherry Studio |图形用户界面|支持|
|Zed | JSON配置|支持|

______________________________________________________________________

## 发展

cd /path/to/twitter-mcp uv sync uv run twitter-mcp

MCP Inspector

npx @modelcontextprotocol/inspector uv --directory /path/to/twitter-mcp run twitter-mcp

### 项目结构

├── README.md ├── docs/ │ ├── README_JA.md # 日本語 │ └── README_KO.md # 한국어 ├── openclaw-skill/opentwitter/ # OpenClaw Skill ├── pyproject.toml ├── config.json └── src/twitter_mcp/ ├── server.py # Entry point ├── app.py # FastMCP instance ├── config.py # Config loader ├── api_client.py # HTTP client └── tools.py # 8 tools

## 许可证

麻省理工学院