Twitter MCP Server

Twitter MCP 服务

一个功能强大的 Twitter 集成，适用于 AI Agent，采用模型上下文协议（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 - 创建 Twitter 串文

时间线工具

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

用户管理工具

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

安装

1. 安装依赖：

npm install

2. 构建服务：

npm run build

3. 配置环境变量：

# Required: Twitter Account Credentials (for user authentication)
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API Authentication (Optional)
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 stringified response or error message
  }]
}

贡献

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

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件