🚀 Twitter MCP 服务器
这是一个强大的 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- 创建 Twitter 线程
时间线工具
get_timeline- 获取不同类型时间线的推文get_list_tweets- 获取 Twitter 列表中的推文get_trends- 获取当前热门话题
用户管理工具
get_user_relationships- 获取关注者或关注列表follow_user- 关注或取消关注用户
📦 安装指南
- 安装依赖项：
npm install
- 构建服务器：
npm run build
- 配置环境变量：
# 必需：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
- 将服务器配置添加到你的 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 检查器进行调试：
npm run inspector
检查器将提供一个 URL，你可以在浏览器中访问调试工具。
🔧 错误处理
服务器实现了全面的错误处理：
- 对所有参数进行输入验证
- 速率限制保护
- 详细的错误消息
- 正确的错误传播
- 用于调试的日志记录
📄 响应格式
所有工具返回的响应都采用一致的格式：
{
content: [{
type: "text",
text: string // JSON 字符串化的响应或错误消息
}]
}
🤝 贡献
欢迎贡献代码！请随时提交拉取请求。
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。