Twitter MCP Server

基本能力

产品定位

Twitter MCP Server 是一个为 AI 代理和 MCP 兼容客户端提供 Twitter 功能集成的服务。

核心功能

1. 基础阅读功能
2. 获取用户推文（支持媒体）
3. 获取用户资料详细信息
4. 按标签或关键词搜索推文
5. 按最新/热门筛选搜索结果

6. 速率限制（每次请求最多 50 条推文）

7. 用户交互功能

8. 点赞/取消点赞推文
9. 转发/取消转发

10. 发布推文（支持文本、媒体附件、回复功能和引用推文）

11. 高级功能

12. 获取用户关系（关注者/正在关注）
13. 获取热门话题
14. 访问不同类型的时间线（主页时间线、关注时间线、用户时间线）

15. 列表管理（获取列表推文）

16. 媒体和高级交互

17. 媒体处理（图片上传：JPEG、PNG、GIF；视频上传：MP4；支持替代文本）
18. 创建线程
19. 关注/取消关注用户

适用场景

• AI 代理需要访问 Twitter 数据
• 需要自动化 Twitter 交互的应用
• 需要集成 Twitter 功能的 MCP 兼容客户端

工具列表

1. 阅读工具
2. get_tweets - 获取用户最近的推文
3. get_profile - 获取用户资料信息

4. search_tweets - 按标签或关键词搜索推文

5. 交互工具

6. like_tweet - 点赞或取消点赞推文
7. retweet - 转发或取消转发
8. post_tweet - 发布新推文（可选媒体）

9. create_thread - 创建 Twitter 线程

10. 时间线工具

11. get_timeline - 获取不同类型时间线的推文
12. get_list_tweets - 获取 Twitter 列表的推文

13. get_trends - 获取当前热门话题

14. 用户管理工具

15. get_user_relationships - 获取关注者或正在关注的列表
16. follow_user - 关注或取消关注用户

常见问题解答

• 所有工具返回的响应格式一致，包含类型和文本内容
• 实现了全面的错误处理，包括输入验证、速率限制保护和详细错误消息
• 提供日志记录用于调试

使用教程

使用依赖

1. 安装 Node.js 环境

安装教程

1. 安装依赖：

npm install

1. 构建服务器：

npm run build

1. 配置环境变量：

# 必需：Twitter 账户凭据（用于用户认证）
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter 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

1. 将服务器配置添加到 MCP 客户端：

MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

调试方式

1. 使用 MCP Inspector 进行调试：

npm run inspector

1. 检查器将提供一个 URL，可在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款。