MCP Twitter

MCP Twitter

site icon
2025.03.21 6
TypeScript社交媒体管理Twitter API 集成交流协作
MCP Twitter 是一个基于 Model Context Protocol 的服务,允许直接与 Twitter/X 进行交互。它通过一系列标准化的工具暴露了 Twitter API 的各种功能,使 AI 模型和应用程序能够在 Twitter 上执行各种操作。
View on GitHub

Overview

基本能力

产品定位

MCP Twitter 是一个用于与 Twitter/X 平台交互的服务,提供了一系列标准化的 API 功能,使 AI 模型和应用程序能够执行 Twitter 上的各种操作。

核心功能

  • create_twitter_post: 创建新的 Twitter 帖子
  • reply_twitter_tweet: 通过 ID 回复特定的 Twitter 帖子
  • get_last_tweet: 获取指定 Twitter 账户的最新帖子
  • get_last_tweets_options: 获取匹配搜索查询的指定数量的帖子
  • create_and_post_twitter_thread: 创建并发布 Twitter 线程
  • follow_twitter_from_username: 通过用户名关注 Twitter 用户
  • get_twitter_profile_from_username: 通过用户名获取完整的 Twitter 个人资料数据
  • get_twitter_user_id_from_username: 通过用户名获取 Twitter 用户 ID
  • get_last_tweet_and_replies_from_user: 获取用户最近的 Twitter 帖子和回复
  • get_last_tweet_from_user: 获取用户最近的 Twitter 帖子
  • get_own_twitter_account_info: 获取当前账户的个人资料数据

适用场景

  • AI 模型需要自动发布 Twitter 内容
  • 应用程序需要集成 Twitter 功能
  • 自动化 Twitter 交互流程
  • 社交媒体监控和分析

工具列表

  • Twitter API 工具集: 提供完整的 Twitter API 功能,包括发帖、回复、获取信息等

常见问题解答

  • 如何选择认证模式(API 或 CREDENTIALS)?
  • 如何正确配置 .env 文件中的凭证?
  • API 有哪些限制?

使用教程

使用依赖

无特殊依赖,只需 Node.js 环境和 Twitter 账户凭证。

安装教程

本地安装

# 克隆仓库
git clone https://github.com/0xhijo/mcp_twitter.git

# 安装依赖并构建项目
pnpm build

# 启动服务器
node ./build/index.js

通过 NPX 安装

npx mcp_twitter

配置

通过 Twitter Scraper 配置

  1. 配置 .env 文件:
TWITTER_AUTH_MODE = "CREDENTIALS" # 凭证模式

# 您的 Twitter 凭证

TWITTER_USERNAME="YOUR_TWITTER_USERNAME"
TWITTER_PASSWORD="YOUR_TWITTER_PASSWORD"
TWITTER_EMAIL="YOUR_TWITTER_EMAIL"

通过 Twitter API 配置

  1. 创建开发者账户
  2. 配置 .env 文件
TWITTER_AUTH_MODE = "API" # API 模式

# 从开发者平台获取的凭证

TWITTER_API="YOUR_TWITTER_API"
TWITTER_API_SECRET="YOUR_TWITTER_API_SECRET"
TWITTER_ACCESS_TOKEN="YOUR_TWITTER_ACCESS_TOKEN"
TWITTER_ACCESS_TOKEN_SECRET="YOUR_TWITTER_ACCESS_TOKEN_SECRET"

与 Claude 集成

要将 MCP Twitter 与 Claude 一起使用,需要将其添加到 claude_mcp_config.json 文件中。

添加到 Claude 的 MCP 配置

claude_mcp_config.json 文件中添加以下条目:

"mcp_twitter": {
  "command": "npx",
  "args": ["mcp_twitter"],
  "env": {
    "TWITTER_AUTH_MODE": "CREDENTIALS",
    "TWITTER_USERNAME": "YOUR_TWITTER_USERNAME",
    "TWITTER_PASSWORD": "YOUR_TWITTER_PASSWORD",
    "TWITTER_EMAIL": "YOUR_TWITTER_EMAIL"
  }
}

调试方式

启动服务器后,可以通过调用提供的 API 端点来测试功能是否正常工作。

重要注意事项

  • 根据需求选择认证模式(API 或 CREDENTIALS)
  • 确保 .env 文件中的凭证配置正确
  • 查阅官方文档了解 API 限制详情

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。