twitter客户端代理mcp

Name: twitter客户端代理mcp
Author: ryanmac

作者：ryanmac18 星标更新：2025-03-12

安装使用来源：spider==github.com

项目介绍

agent-twitter-client-mcp

这是一个通过 agent-twitter-client 包与 Twitter 集成的 Model Context Protocol (MCP) 服务器，允许 AI 模型在没有直接 API 访问的情况下与 Twitter 进行交互。

功能

认证选项：
- 基于 Cookie 的认证（推荐）
- 用户名/密码认证
- Twitter API v2 凭证
推文操作：
- 获取用户的推文
- 根据 ID 获取特定推文
- 搜索推文
- 发送带有文本和媒体的推文
- 创建投票
- 点赞、转发和引用推文
用户操作：
- 获取用户资料
- 关注用户
- 获取关注者和关注列表
Grok 集成：
- 通过 Twitter 接口与 Grok 聊天
- 使用对话 ID 继续对话
- 获取网络搜索结果和引用
- 通过 Grok 访问 Twitter 的实时数据
- 注意：Grok 功能需要 agent-twitter-client v0.0.19 或更高版本

文档

开发者指南 - 开发者的综合指南
测试指南 - 测试 MCP 的说明
代理指南 - AI 代理如何使用 Twitter MCP 的指南
贡献指南 - 贡献此项目的指导方针
变更日志 - 此项目更改的历史记录
演示 README - 运行演示脚本的指南
Grok 示例 - Grok AI 集成示例的文档

快速开始

安装

# 全局安装
npm install -g agent-twitter-client-mcp

# 或本地安装
npm install agent-twitter-client-mcp

基本用法

创建一个包含您的 Twitter 凭证的 .env 文件（参见 [认证方法](#认证方法））
运行 MCP 服务器：

# 如果全局安装
agent-twitter-client-mcp

# 如果本地安装
npx agent-twitter-client-mcp

演示脚本

该包包括一个 demo 目录，其中包含演示各种功能的示例脚本：

# 克隆仓库以访问演示脚本
git clone https://github.com/ryanmac/agent-twitter-client-mcp.git
cd agent-twitter-client-mcp/demo

# 运行交互式演示菜单
./run-demo.sh

# 运行特定的演示脚本
./run-demo.sh --script tweet-search.js

# 运行 Grok AI 示例（需要 agent-twitter-client v0.0.19）
./run-demo.sh --script simple-grok.js --use-local-agent-twitter-client
./run-demo.sh --script grok-chat.js --use-local-agent-twitter-client

更多详情，请参阅演示 README。

端口配置

默认情况下，MCP 服务器运行在 3000 端口。如果您需要更改此设置（例如，如果已经有应用程序在 3000 端口上运行），您有几种选择：

选项 1：使用环境变量

设置 PORT 环境变量：

PORT=3001 npx agent-twitter-client-mcp

选项 2：使用 Docker Compose

如果使用 Docker Compose，您可以在 .env 文件中配置主机和容器端口：

# .env 文件
MCP_HOST_PORT=3001    # 主机上的端口
MCP_CONTAINER_PORT=3000  # 容器内的端口

然后运行：

docker-compose up -d

这将把主机上的 3001 端口映射到容器内的 3000 端口，这样您可以通过 http://localhost:3001 访问 MCP，而其他应用程序继续使用 3000 端口。

与 Claude Desktop 设置

配置 Claude Desktop 使用此 MCP，在您的配置文件中添加以下内容：

Windows：%APPDATA%\Claude\claude_desktop_config.json macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agent-twitter-client-mcp": {
      "command": "npx",
      "args": ["-y", "agent-twitter-client-mcp"],
      "env": {
        "AUTH_METHOD": "cookies",
        "TWITTER_COOKIES": "[\"auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com\", \"ct0=YOUR_CT0_VALUE; Domain=.twitter.com\", \"twid=u%3DYOUR_USER_ID; Domain=.twitter.com\"]"
      }
    }
  }
}

重启 Claude Desktop

认证方法

Cookie 认证（推荐）

{
  "AUTH_METHOD": "cookies",
  "TWITTER_COOKIES": "[\"auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com\", \"ct0=YOUR_CT0_VALUE; Domain=.twitter.com\", \"twid=u%3DYOUR_USER_ID; Domain=.twitter.com\"]"
}

要获取 Cookie：

在浏览器中登录 Twitter
打开开发者工具（F12）
转到“应用”标签 > Cookies
复制 auth_token、ct0 和 twid Cookie 的值
确保每个 Cookie 包含 Domain=.twitter.com 部分

用户名/密码认证

{
  "AUTH_METHOD": "credentials",
  "TWITTER_USERNAME": "your_username",
  "TWITTER_PASSWORD": "your_password",
  "TWITTER_EMAIL": "your_email@example.com", // 可选
  "TWITTER_2FA_SECRET": "your_2fa_secret" // 可选，如果启用了双因素认证则需要
}

Twitter API 认证

{
  "AUTH_METHOD": "api",
  "TWITTER_API_KEY": "your_api_key",
  "TWITTER_API_SECRET_KEY": "your_api_secret_key",
  "TWITTER_ACCESS_TOKEN": "your_access_token",
  "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
}

可用工具

get_user_tweets：从特定用户获取推文
get_tweet_by_id：根据 ID 获取特定推文
search_tweets：搜索推文
send_tweet：发布新推文
send_tweet_with_poll：发布带有投票的推文
like_tweet：点赞推文
retweet：转发推文
quote_tweet：引用推文
get_user_profile：获取用户资料
follow_user：关注用户
get_followers：获取用户的关注者
get_following：获取用户正在关注的人
grok_chat：通过 Twitter 与 Grok 聊天
health_check：检查 Twitter MCP 服务器的状态

测试接口

MCP 包括一个用于测试的交互式命令行界面：

npx agent-twitter-client-mcp-test
# 或如果本地安装
npm run test:interface

这将启动一个 REPL，您可以在此处测试各种 MCP 函数：

agent-twitter-client-mcp> help

可用命令：
  health                     运行健康检查
  profile <username>         获取用户资料
  tweets <username> [count]  获取用户的推文
  tweet <id>                 根据 ID 获取特定推文
  search <query> [count]     搜索推文
  post <text>                发布新推文
  like <id>                  点赞推文
  retweet <id>               转发推文
  quote <id> <text>          引用推文
  follow <username>          关注用户
  followers <userId> [count] 获取用户的关注者
  following <userId> [count] 获取用户正在关注的人
  grok <message>             与 Grok 聊天
  help                       显示可用命令
  exit                       退出测试界面

示例测试命令

# 运行健康检查
agent-twitter-client-mcp> health

# 搜索推文
agent-twitter-client-mcp> search mcp 2

# 获取用户资料
agent-twitter-client-mcp> profile elonmusk

# 获取用户的推文
agent-twitter-client-mcp> tweets openai 5

# 与 Grok 聊天
agent-twitter-client-mcp> grok 解释量子计算的简单概念

示例用法

让 Claude：

“在 Twitter 上搜索关于 AI 的推文”
“发布一条推文说‘来自 Claude 的问候！’”
“获取 @OpenAI 的最新推文”
“与 Grok 聊天讨论量子计算”

高级用法

处理媒体

要发布带有图片的推文：

我想发布一条带有图片的推文。推文应说“今天美丽的日落！”并包含这张图片。

要发布带有视频的推文：

我想发布一条带有视频的推文。推文应说“看看这段惊人的视频！”并包含视频文件。

创建投票

要创建投票：

创建一个 Twitter 投票，问题为“你最喜欢的编程语言是什么？”选项为：Python、JavaScript、Rust 和 Go。投票持续 24 小时。

与 Grok 互动

要与 Grok 聊天：

使用 Grok 向我解释量子计算。让它包括一些实际应用。

要继续与 Grok 的对话：

继续与 Grok 的对话，并让它详细解释量子纠缠。

Grok 的独特能力

Twitter 上的 Grok 可访问实时 Twitter 数据，即使独立的 Grok API 也无法访问这些数据。这意味着您可以询问 Grok 关于：

当前在 Twitter 上的趋势话题
对特定主题的最近推文进行分析
关于 Twitter 用户及其内容的信息
平台上正在讨论的实时事件

示例查询：

“现在 Twitter 上的趋势话题是什么？”
“分析 Twitter 上关于 AI 的情绪”
“人们在谈论最新的苹果活动吗？”
“显示今天讨论的流行 meme 币信息”

Grok 认证要求

Grok 功能需要适当的认证。MCP 支持两种方法：

Cookie 认证（推荐）：
- Cookie 必须是 JSON 数组格式
- 示例：TWITTER_COOKIES=["auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com", "ct0=YOUR_CT0_VALUE; Domain=.twitter.com", "twid=u%3DYOUR_USER_ID; Domain=.twitter.com"]
- 必需的 Cookie 是 auth_token、ct0 和 twid
用户名/密码认证：
- 在您的环境中设置 TWITTER_USERNAME 和 TWITTER_PASSWORD
- 在某些情况下可能会遇到 Cloudflare 保护

Grok 的速率限制

Grok 有速率限制，可能会影响使用：

非高级账户：每 2 小时 25 条消息
高级账户：更高的限制

当达到限制时，MCP 将在响应中返回速率限制信息。

有关使用 Grok 的更多详细信息，请参阅 Grok 示例文档。

故障排除

认证问题

Cookie 认证问题

如果您遇到 Cookie 认证问题：

Cookie 过期：Twitter Cookie 通常会在一段时间后过期。尝试通过注销并重新登录 Twitter 刷新您的 Cookie。
Cookie 格式：确保您的 Cookie 正确格式化为字符串的 JSON 数组，并具有正确的域。
必需的 Cookie：确保您已包含必需的 Cookie：auth_token、ct0 和 twid。

正确格式化的 Cookie 示例：

"TWITTER_COOKIES": "[\"auth_token=1234567890abcdef; Domain=.twitter.com\", \"ct0=abcdef1234567890; Domain=.twitter.com\", \"twid=u%3D1234567890; Domain=.twitter.com\"]"

凭证认证问题

如果您遇到用户名/密码认证问题：

双因素认证：如果您的帐户启用了 2FA，则需要提供 TWITTER_2FA_SECRET。
帐户锁定：过多的失败登录尝试可能会锁定您的帐户。检查您的电子邮件以查看帐户验证请求。
验证码挑战：Twitter 可能会呈现验证码挑战，客户端无法自动处理。

API 认证问题

对于 API 认证问题：

API 密钥权限：确保您的 API 密钥具有执行所需操作所需的权限。
速率限制：Twitter API 有速率限制，如果超过可能会导致失败。
API 更改：Twitter 不时更改其 API，这可能导致兼容性问题。

操作错误

发布推文失败

如果您无法发布推文：

内容限制：Twitter 可能会阻止违反其内容政策的推文。
媒体格式问题：确保媒体正确格式化和编码。
速率限制：Twitter 限制了您发布推文的频率。

搜索问题

如果搜索不起作用：

查询语法：确保您的搜索查询遵循 Twitter 的搜索语法。
搜索限制：某些搜索模式可能有限制或需要特定权限。

Grok 问题

如果 Grok 功能不起作用：

版本要求：
- Grok 需要 agent-twitter-client v0.0.19 或更高版本
- 当前包使用 v0.0.18 实现基本功能
- 对于演示脚本，使用 --use-local-agent-twitter-client 标志临时安装 v0.0.19
认证问题：
- Cookie 格式：确保 Cookie 是正确的 JSON 数组格式
- Cookie 有效性：Twitter Cookie 在一定时间后会过期
- Cloudflare 保护：用户名/密码认证可能会被 Cloudflare 阻止
- 高级要求：访问 Grok 需要 Twitter 高级订阅
速率限制：
- 非高级账户：每 2 小时 25 条消息
- 错误消息：“速率限制：您已达到限制...”
- 解决方案：等待速率限制重置或升级到高级账户
环境文件位置：
- 对于演示脚本，确保您的凭据位于 demo/.env 中，而不是根目录中的 .env 文件
- 使用 --debug-env 标志检查加载哪些环境变量

有关 Grok 问题的详细故障排除，请参阅 Grok 示例文档。

服务器问题

健康检查

使用 health_check 工具诊断服务器问题：

对 agent-twitter-client-mcp 服务器运行健康检查以诊断任何问题。

健康检查将报告：

认证状态
API 连接性
内存使用情况

日志

服务器将日志记录到控制台和文件中：

error.log：包含错误级别的消息
combined.log：包含所有日志消息

检查这些日志以获取详细的错误信息。

开发

先决条件

Node.js 18+
npm

设置

克隆仓库

git clone https://github.com/ryanmac/agent-twitter-client-mcp.git
cd agent-twitter-client-mcp

安装依赖项

npm install

创建一个包含配置的 .env 文件：

AUTH_METHOD=cookies
TWITTER_COOKIES=["cookie1=value1", "cookie2=value2"]

构建项目

npm run build

启动服务器

npm start

环境变量

除了认证变量外，还可以设置：

LOG_LEVEL：设置日志级别（error、warn、info、debug）
NODE_ENV：设置环境（development、production）

Docker

您也可以使用 Docker 运行服务器：

直接使用 Docker

# 构建 Docker 镜像
docker build -t agent-twitter-client-mcp .

# 使用环境变量运行容器
docker run -p 3000:3000 \
  -e AUTH_METHOD=cookies \
  -e TWITTER_COOKIES='["auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com", "ct0=YOUR_CT0_VALUE; Domain=.twitter.com"]' \
  agent-twitter-client-mcp

使用 Docker Compose

创建一个包含您的 Twitter 凭证的 .env 文件
使用 docker-compose 运行：

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down