8大AI客户端接入opentwitter-mcp完整清单:Claude Desktop、Cursor、Cline、Zed快速配置
8大AI客户端接入opentwitter-mcp完整清单:Claude Desktop、Cursor、Cline、Zed快速配置
opentwitter-mcp 是一个开源的 Twitter/X 数据 MCP 服务器,让 Claude Desktop、Cursor、Cline、Zed 等 AI 客户端用自然语言直接查询用户资料、搜索推文、追踪关注事件和 KOL 动态。本文汇总 8 大 AI 客户端的完整接入清单与快速配置方法:只需一个 API Token 和一行启动命令,即可在任意 stdio 客户端中调用 17 个 Twitter 数据工具。
一、opentwitter-mcp 能做什么?
配置完成后,你对 AI 助手说什么,它就能做什么 🧩:
| 你说 | 它做 |
|---|---|
| "查看 @elonmusk 的资料" | 获取用户资料 |
| "VitalikButerin 最近发了什么" | 获取用户近期推文 |
| "搜索 Bitcoin 相关推文" | 关键词 / 标签搜索 |
| "ETH 热门推文,1000 赞以上" | 互动量筛选 |
| "最近谁关注了 @elonmusk" | 获取新关注事件 |
| "哪些大 V 关注了 @elonmusk" | 获取 KOL 关注者 |
| "elonmusk 删了哪些推文" | 获取删推数据 |
它封装了 17 个工具(如 get_twitter_user、search_twitter、get_twitter_follower_events、get_twitter_kol_followers 等),全部实现集中在 src/opentwitter_mcp/tools.py,服务入口在 src/opentwitter_mcp/server.py。中文说明可参考 docs/README_ZH.md。
二、准备工作:获取 Token + 克隆仓库
第 1 步:申请 API Token
前往 app.newsliquid.com/mcp 页面获取你的 API Token,这是唯一的硬性前置条件 🔑
第 2 步:克隆仓库到本地
git clone https://gitcode.com/gh_mirrors/op/opentwitter-mcp
第 3 步:确认已安装 uv 和 Python 3.10+
项目依赖极少,只有 mcp 和 httpx 两个包(见 pyproject.toml),uv 会自动处理依赖环境。
💡 后面所有配置中的
<本地项目路径>都指 clone 下来的opentwitter-mcp目录绝对路径。
三、8 大 AI 客户端快速配置清单
所有客户端的启动方式相同,核心就是一行 stdio 命令:
OPENNEWS_TOKEN=<你的Token> uv --directory <本地项目路径> run opentwitter-mcp
下面按客户端给出各自的配置文件位置与写法。
1. Claude Code:一行命令搞定
claude mcp add opentwitter \
-e OPENNEWS_TOKEN=<你的Token> \
-- uv --directory <本地项目路径> run opentwitter-mcp
2. Claude Desktop:编辑 claude_desktop_config.json
配置文件位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"opentwitter": {
"command": "uv",
"args": ["--directory", "<本地项目路径>", "run", "opentwitter-mcp"],
"env": {
"OPENNEWS_TOKEN": "<你的Token>"
}
}
}
}
3. Cursor:mcp.json 或设置面板
编辑 ~/.cursor/mcp.json(或在 Settings > MCP Servers 中添加):
{
"mcpServers": {
"opentwitter": {
"command": "uv",
"args": ["--directory", "<本地项目路径>", "run", "opentwitter-mcp"],
"env": {
"OPENNEWS_TOKEN": "<你的Token>"
}
}
}
}
4. Windsurf:mcp_config.json
编辑 ~/.codeium/windsurf/mcp_config.json,内容格式与 Cursor 完全相同(同上 mcpServers 结构)。
5. Cline:VS Code 侧边栏配置
路径:VS Code 侧边栏 > Cline > MCP Servers > Configure,编辑 cline_mcp_settings.json:
{
"mcpServers": {
"opentwitter": {
"command": "uv",
"args": ["--directory", "<本地项目路径>", "run", "opentwitter-mcp"],
"env": {
"OPENNEWS_TOKEN": "<你的Token>"
},
"disabled": false,
"autoApprove": []
}
}
}
如果希望某些工具免审批自动执行,可把工具名填入
autoApprove数组。
6. Continue.dev:config.yaml
编辑 ~/.continue/config.yaml:
mcpServers:
- name: opentwitter
command: uv
args:
- --directory
- <本地项目路径>
- run
- opentwitter-mcp
env:
OPENNEWS_TOKEN: <你的Token>
7. Cherry Studio:图形界面填写
进入 Settings > MCP Servers > Add,选择类型 stdio:
- Command:
uv - Args:
--directory <本地项目路径> run opentwitter-mcp - Env:
OPENNEWS_TOKEN= 你的 Token
8. Zed Editor:settings.json 的 context_servers
编辑 ~/.config/zed/settings.json:
{
"context_servers": {
"opentwitter": {
"command": {
"path": "uv",
"args": ["--directory", "<本地项目路径>", "run", "opentwitter-mcp"],
"env": {
"OPENNEWS_TOKEN": "<你的Token>"
}
}
}
}
}
📌 附赠:如果你用 OpenClaw,无需 stdio 配置,直接
export OPENNEWS_TOKEN="<你的Token>"后把 skill 目录复制到~/.openclaw/skills/即可,详见 openclaw-skill/opentwitter/SKILL.md。
四、配置项速查表
| 变量 | 必填 | 说明 |
|---|---|---|
OPENNEWS_TOKEN |
✅ | API Bearer Token |
TWITTER_API_BASE |
❌ | 覆盖 REST API 地址(默认 https://ai.6551.io) |
TWITTER_MAX_ROWS |
❌ | 每次查询最大返回条数(默认 100) |
除了环境变量,也支持把 api_token 写入项目根目录的 config.json,环境变量优先级更高。加载逻辑见 src/opentwitter_mcp/config.py。
五、配置失败?三个常见问题
-
报
OPENNEWS_TOKEN not configured错误 说明 Token 没配好。检查客户端配置里的env是否生效,或把 Token 填入 config.json 的api_token字段后重启客户端。 -
提示找不到
uv命令 先安装 uv(如pip install uv),并确保它在客户端能找到的 PATH 中;如果用了绝对路径仍失败,把command改为 uv 的完整路径。 -
客户端里看不到 17 个工具 依次核对:
--directory后的路径是否指向仓库根目录、run后面的命令是否为opentwitter-mcp、改完配置后是否重启了客户端。也可以先用 MCP Inspector 单独验证服务本身:npx @modelcontextprotocol/inspector uv --directory <本地项目路径> run opentwitter-mcp
六、上手后的玩法建议
接入成功后,可以从 README.md 的"What Can It Do?"表格开始体验。几个高频场景:
- 📊 KOL 情报:"最近哪些大 V 关注了 @某账号"(
get_twitter_kol_followers) - 🔍 热点检索:"找 #crypto 标签下 100 赞以上的推文"(
search_twitter的hashtag+minLikes过滤) - 🗑️ 删推监控:配合
add_twitter_watch添加监控名单,再用get_twitter_deleted_tweets定期查看删推动态 - 📡 实时订阅:项目还支持 WebSocket 实时事件推送(新推文、新关注、资料变更等),协议细节见 README.md 的 "WebSocket Real-time Subscriptions" 章节
📁 本文涉及的项目文件:README.md · pyproject.toml · config.json · src/opentwitter_mcp/tools.py · src/opentwitter_mcp/config.py · docs/README_ZH.md · openclaw-skill/opentwitter/SKILL.md