🚀 Twitter MCP 服务器
这是一款功能强大的推特集成工具，专为 AI 代理量身打造。它借助 Model Context Protocol (MCP) 标准，为推特功能提供全面支持，拥有简洁且统一的接口，能极大提升使用效率。
🚀 快速开始
安装步骤
- 安装依赖：
npm install
- 构建服务器：
npm run build
- 配置环境变量：
# 必填：推特账号凭证（用于用户认证）
TWITTER_USERNAME=你的用户名
TWITTER_PASSWORD=你的密码
TWITTER_EMAIL=你的邮箱
# 推特 API 认证（可选）
TWITTER_API_KEY=你的API密钥
TWITTER_API_SECRET_KEY=你的API密钥秘密
TWITTER_ACCESS_TOKEN=你的访问令牌
TWITTER_ACCESS_TOKEN_SECRET=你的访问令牌秘密
- 配置文件示例：
# .env 文件示例配置
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
启动服务器
npm run start
示例命令
# 获取推文示例
curl -X GET http://localhost:3000/api/tweets
# 发布推文示例
curl -X POST http://localhost:3000/api/tweets \
-H "Content-Type: application/json" \
-d '{"text":"Hello, Twitter!"}'
✨ 主要特性
基本阅读
- 可获取带有媒体支持的用户推文。
- 能获取详细的用户资料信息。
- 支持根据 hashtag 或关键词搜索推文。
- 可根据最新/热门过滤搜索结果。
- 具备限流保护（每请求最多50条推文）。
用户互动
- 可赞成/取消赞成推文。
- 能转发/取消转发推文。
- 支持发布推文，涵盖以下功能：
- 文本内容发布。
- 媒体附件（图片、视频）添加。
- 回复功能。
- 引用推文功能。
高级特性
- 可获取用户关系（关注者/关注列表）。
- 能获取 trending topics。
- 支持访问不同时间线类型：
- 主动时间线。
- 关注时间线。
- 用户时间线。
- 支持列表管理（获取列表推文）。
媒体及高级互动
- 媒体处理：
- 支持图片上传（JPEG, PNG, GIF）。
- 支持视频上传（MP4）。
- 具备 Alt 文本支持。
- 可创建线程。
- 能关注/取消关注用户。
🛠️ 工具
阅读工具
get_tweets- 获取用户的最近推文。get_profile- 获取用户资料信息。search_tweets- 根据 hashtag 或关键词搜索推文。
互动工具
like_tweet- 赞成或取消赞成推文。retweet- 转发或取消转发。post_tweet- 发布新推文，支持附件。create_thread- 创建 Twitter 线程。
时间线工具
get_timeline- 获取不同时间线类型推文。get_list_tweets- 获取列表推文。get_trends- 获取当前 trending topics。
用户管理工具
get_user_relationships- 获取关注者或关注列表。follow_user- 关注或取消关注用户。
📚 详细文档
错误处理
所有 API 请求都返回 JSON 格式的响应：
{
"success": boolean,
"error": string|null,
"result": any
}
📄 许可证
项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。
🤝 贡献指南
欢迎通过提交拉取请求为该项目做出贡献。请阅读 CONTRIBUTING.md 文件获取更多信息。
感谢使用 Twitter MCP 服务器！如需帮助，请访问我们的 GitHub 页面 或联系支持邮箱：support@twittermcp.com。