agent-twitter-client-mcp

基本能力

产品定位

twitter-mcp-server 是一个用于 AI 模型与 Twitter 交互的中间件服务，提供丰富的 Twitter 操作功能，支持多种认证方式，并集成了 Grok AI 功能。

核心功能

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

• Twitter API v2 认证

• 推文操作：

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

• 点赞、转发和引用推文

• 用户操作：

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

• 获取关注者和被关注者列表

• Grok 集成：

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

适用场景

• AI 模型需要与 Twitter 交互的场景
• 自动化 Twitter 操作（如自动发推、搜索、关注等）
• 通过 Grok AI 进行实时数据分析或聊天

工具列表

• 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: 与 Grok 聊天
• health_check: 检查 Twitter MCP 服务器的健康状况

常见问题解答

• 认证问题：
• Cookie 过期或格式不正确
• 用户名/密码认证可能触发 Cloudflare 保护

• API 密钥权限不足

• 操作错误：

• 推文内容受限
• 媒体格式问题

• 搜索语法错误

• Grok 问题：

• 需要特定版本的 agent-twitter-client
• 认证问题
• 速率限制

使用教程

使用依赖

• 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

调试方式

# 运行测试接口
npx agent-twitter-client-mcp-test

# 或
npm run test:interface

示例测试命令

# 运行健康检查
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 Explain quantum computing in simple terms

许可证

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