Twitter MCP 服务器

一个强大的 Twitter 集成方案，适用于 AI 代理，并利用了 Model Context Protocol (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 - 关注或取消关注用户

安装

安装依赖项：

npm install

构建服务器：

npm run build

配置环境变量：

# 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

将服务器配置添加到您的 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 服务器通过标准输入输出通信，您可以使用 MCP Inspector 进行调试：

npm run inspector

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

错误处理

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

对所有参数进行输入验证
速率限制保护
详细的错误消息
正确的错误传播
用于调试的日志记录

响应格式

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

{
  content: [{
    type: "text",
    text: string // JSON stringified response or error message
  }]
}

贡献

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

许可证

[此处填写许可证信息]

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