Twitter MCP Server

基本能力

产品定位

Twitter MCP Server 是一个为AI代理提供Twitter功能集成的服务，通过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. 创建线程
20. 关注/取消关注用户

适用场景

• 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 - 关注或取消关注用户

常见问题解答

• 所有工具返回的响应格式一致，包含类型和文本内容
• 服务器实现了全面的错误处理，包括输入验证、速率限制保护和详细错误消息
• 调试可以通过MCP Inspector进行

使用教程

使用依赖

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. 开发时自动重建:

npm run watch

许可证

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