agent-twitter-client-mcp

基本能力

产品定位

agent-twitter-client-mcp 是一个用于 AI 模型与 Twitter 交互的中间件服务，旨在简化 Twitter 功能的集成和使用。

核心功能

• 认证选项：
• 基于 Cookie 的认证（推荐）
• 用户名/密码认证

• Twitter API v2 凭证认证

• 推文操作：

• 获取用户推文
• 通过 ID 获取特定推文
• 搜索推文
• 发送带文本和媒体的推文
• 创建投票

• 点赞、转发和引用推文

• 用户操作：

• 获取用户资料
• 关注用户

• 获取关注者和关注列表

• Grok 集成：

• 通过 Twitter 界面与 Grok 聊天
• 使用会话 ID 继续对话
• 获取网络搜索结果和引用
• 通过 Grok 访问 Twitter 实时数据

适用场景

• AI 模型需要与 Twitter 进行交互
• 自动化 Twitter 操作（如发布推文、搜索内容等）
• 通过 Grok 获取 Twitter 实时数据

工具列表

• 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 服务器的健康状况

常见问题解答

• 认证问题：确保 Cookie 格式正确且未过期，用户名/密码认证可能需要 2FA 密钥。
• Grok 功能问题：确保使用 agent-twitter-client v0.0.19 或更高版本，并正确配置认证信息。
• 服务器问题：使用 health_check 工具诊断服务器问题，检查日志文件获取详细错误信息。

使用教程

使用依赖

• Node.js 18+
• npm

安装教程

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

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

调试方式

1. 创建 .env 文件并配置 Twitter 凭证
2. 运行 MCP 服务器：

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

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

1. 使用测试接口进行调试：

npx agent-twitter-client-mcp-test
# 或
npm run test:interface

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。