X (Twitter) MCP Server

X (Twitter) MCP Server

site icon
2025.04.06 1
Python社交媒体管理内容聚合自动化营销交流协作
Twitter MCP Server 是一个允许客户端与 X(原 Twitter)平台进行交互的服务,支持包括发布推文、搜索内容、管理账户和组织列表等全面的平台操作。
View on GitHub

Overview

基本能力

产品定位

Twitter MCP Server 旨在提供一个与 X(原 Twitter)平台交互的中间件,使开发者能够通过 MCP 协议轻松集成 Twitter 功能到他们的应用中。

核心功能

  • 发布操作:发布内容(最多 280 个字符),按查询搜索帖子并可自定义结果数量。
  • 账户管理:获取任何用户或认证账户的个人资料信息,更新个人资料详情(名称、简介、位置、网站 URL),关注和取消关注用户,列出用户或认证账户的关注者和正在关注的账户。
  • 列表管理:创建新列表(公开或私有),获取特定列表的信息,检索认证用户拥有的所有列表。

适用场景

  • 社交媒体管理工具
  • 内容聚合平台
  • 自动化营销工具
  • 个人社交媒体助手

工具列表

工具名称 描述
post_tweet 在 X 上发布新内容
search_tweets 在 X 上搜索内容
get_profile 获取用户或认证账户的个人资料信息
update_profile 更新认证用户的个人资料
follow_user 关注用户
unfollow_user 取消关注用户
list_followers 列出用户或认证账户的关注者
list_following 列出用户或认证账户正在关注的账户
create_list 创建新列表
get_list_info 获取列表信息
get_user_lists 获取认证用户拥有的所有列表

常见问题解答

  • 如何获取 API 密钥?:需要创建 X 开发者账户并从 X Developer Portal 获取 API 密钥。
  • 如何设置环境变量?:可以通过直接在命令行中设置环境变量或使用 .env 文件来配置 API 密钥。

使用教程

使用依赖

  • Node.js 18.x 或更高版本
  • X 开发者账户,具有 API v1 和 v2 访问权限

安装教程

  1. 克隆仓库:
git clone https://github.com/Dishant27/twitter-mcp.git
  1. 安装依赖:
npm install
  1. 运行服务器:
  2. 使用环境变量:
TWITTER_API_KEY=your_api_key \
TWITTER_API_SECRET=your_api_secret \
TWITTER_ACCESS_TOKEN=your_access_token \
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret \
npm start
  • 使用 .env 文件:
echo "TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret" > .env
npm start

调试方式

  • 确保所有环境变量已正确设置。
  • 检查服务器日志以确认服务已成功启动。
  • 使用 MCP 客户端(如 Claude)进行功能测试。

许可证

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