JinDaGe - twitter-mcp-server MCP Details

article

README

🚀 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。

twitter-mcp-server