Twitter MCP Server

一个强大的Twitter集成工具，适用于AI代理，利用模型上下文协议（MCP）标准，通过简洁一致的接口提供全面的Twitter功能。

概述

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

功能

基本阅读

• 获取带有媒体支持的用户推文
• 获取包含详细信息的用户资料
• 根据主题标签或关键词搜索推文
• 根据最新或热门过滤搜索结果
• 速率限制（每个请求最多50条推文）

用户互动

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

高级功能

• 获取用户关系（关注者/关注中）
• 获取热门话题
• 访问不同时间线类型：
  • 主页时间线
  • 关注时间线
  • 用户时间线
• 列表管理（获取列表推文）

媒体及高级互动

• 媒体处理：
  • 图片上传（JPEG、PNG、GIF）
  • 视频上传（MP4）
  • 替代文本支持
• 创建推文串
• 关注/取消关注用户

工具

阅读工具

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

互动工具

• like_tweet - 点赞或取消点赞推文
• retweet - 转发或取消转发
• post_tweet - 发布新的推文，可选带媒体
• create_thread - 创建推文串

时间线工具

• get_timeline - 获取不同类型的时间线推文
• get_list_tweets - 获取Twitter列表中的推文
• get_trends - 获取当前热门话题

用户管理工具

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

安装

1. 安装依赖项：

npm install

2. 构建服务器：

npm run build

3. 配置环境变量：

# 必需：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

4. 将服务器配置添加到您的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"
    }
  }
}

开发

为了开发并自动重建：

npm run watch

调试

由于MCP服务器通过stdio通信，您可以使用MCP Inspector进行调试：

npm run inspector

Inspector会提供一个URL，以便您在浏览器中访问调试工具。

错误处理

服务器实现了全面的错误处理：

• 所有参数的输入验证
• 速率限制保护
• 详细的错误消息
• 正确的错误传播
• 调试日志

响应格式

所有工具返回一致的响应格式：

{
  content: [{
    type: "text",
    text: string // JSON字符串化的响应或错误消息
  }]
}

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT许可证 - 详情见LICENSE文件