8大AI客户端接入opentwitter-mcp完整清单:Claude Desktop、Cursor、Cline、Zed快速配置

原创2026-10-11 16:07:491,629 阅读

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。

五、配置失败?三个常见问题

  1. 报 OPENNEWS_TOKEN not configured 错误 说明 Token 没配好。检查客户端配置里的 env 是否生效,或把 Token 填入 config.json 的 api_token 字段后重启客户端。

  2. 提示找不到 uv 命令 先安装 uv(如 pip install uv),并确保它在客户端能找到的 PATH 中;如果用了绝对路径仍失败,把 command 改为 uv 的完整路径。

  3. 客户端里看不到 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

登录后查看全文
opentwitter-mcp