Twitter MCP 服务器

一个功能强大的推特集成工具，专为 AI代理设计，通过 Model Context Protocol (MCP) 标准提供全面的推特功能支持，具有简洁一致的接口。

概述

该服务器通过 MCP 工具提供对推特功能的访问，实现与 AI 助手和其他 MCP 兼容客户端的无缝集成。它基于 agent-twitter-client 库构建，并提供强大的错误处理、速率限制和一致的响应格式。

特性

基本阅读

• 获取带有媒体支持的用户推文
• 获取详细的用户资料信息
• 搜索 hashtag 或关键词推文
• 根据最新/热门过滤搜索结果
• 限流保护（每请求最多50条推文）

用户互动

• 赞成/取消赞成推文
• 转发/取消转发推文
• 发布推文，支持：
  • 文本内容
  • 媒体附件（图片、视频）
  • 回复功能
  • 引用推文功能

高级特性

• 获取用户关系（关注者/关注列表）
• 获取 trending topics
• 访问不同时间线类型：
  • 主动时间线
  • 关注时间线
  • 用户时间线
• 列表管理（获取列表推文）

媒体及高级互动

• 媒体处理：
  • 图片上传（JPEG, PNG, GIF）
  • 视频上传（MP4）
  • Alt 文本支持
• 创建线程
• 关注/取消关注用户

工具

阅读工具

• get_tweets - 获取用户的最近推文
• get_profile - 获取用户资料信息
• search_tweets - 根据 hashtag 或关键词搜索推文

互动工具

• like_tweet - 赞成或取消赞成推文
• retweet - 转发或取消转发
• post_tweet - 发布新推文，支持附件
• create_thread - 创建 Twitter 线程

时间线工具

• get_timeline - 获取不同时间线类型推文
• get_list_tweets - 获取列表推文
• get_trends - 获取当前 trending topics

用户管理工具

• get_user_relationships - 获取关注者或关注列表
• follow_user - 关注或取消关注用户

安装

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 配置环境变量：

# 必填：推特账号凭证（用于用户认证）
TWITTER_USERNAME=你的用户名
TWITTER_PASSWORD=你的密码
TWITTER_EMAIL=你的邮箱

# 推特 API 认证（可选）
TWITTER_API_KEY=你的API密钥
TWITTER_API_SECRET_KEY=你的API密钥秘密
TWITTER_ACCESS_TOKEN=你的访问令牌
TWITTER_ACCESS_TOKEN_SECRET=你的访问令牌秘密

4. 配置文件示例：

# .env 文件示例配置
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

使用说明

初始化服务器

npm run start

示例命令

# 获取推文示例
curl -X GET http://localhost:3000/api/tweets

# 发布推文示例
curl -X POST http://localhost:3000/api/tweets \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, Twitter!"}'

错误处理

所有 API 请求都返回 JSON 格式的响应：

{
  "success": boolean,
  "error": string|null,
  "result": any
}

许可证

项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。

贡献指南

欢迎通过提交拉取请求为该项目做出贡献。请阅读 CONTRIBUTING.md 文件获取更多信息。

感谢使用 Twitter MCP 服务器！如需帮助，请访问我们的 GitHub 页面 或联系支持邮箱：support@twittermcp.com。