Twitter推特管理
启用与X(前身为推特)的互动,允许发布推文、搜索内容、管理账户和整理列表。
服务介绍
X (Twitter) MCP 服务器
此MCP服务器允许客户端与X(前身为Twitter)进行交互,支持包括发推文、搜索内容、管理账户和组织列表在内的全面平台操作。
快速开始
- 创建一个X开发者账号,并从X开发者门户获取您的API密钥
- 将所有必需的API密钥设置为环境变量
- 克隆此仓库:
git clone https://github.com/Dishant27/twitter-mcp.git - 安装依赖项:
npm install - 运行服务器:
- 使用环境变量:
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文件:
# Create a .env file with your X API keys
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
# Start the server
npm start
- 与MCP客户端(如Claude)一起使用。
Claude 配置
要将此服务器与Claude一起使用,您需要设置MCP配置。以下是配置结构的一个示例:
{
"name": "x",
"display_name": "X",
"description": "X MCP allows Claude to interact with X (formerly Twitter)",
"path": "path/to/twitter-mcp/dist/index.js",
"startup": {
"env": {
"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"
}
},
"transport": "stdio"
}
将此配置保存在Claude MCP配置目录中,通常位于:
- Windows:
%APPDATA%\AnthropicClaude\mcp-servers - macOS:
~/Library/Application Support/AnthropicClaude/mcp-servers - Linux:
~/.config/AnthropicClaude/mcp-servers
功能
发布操作
- 发布内容(最多280个字符)
- 通过查询搜索帖子并自定义结果数量
账户管理
- 获取任何用户或已验证账户的个人资料信息
- 更新个人资料详情(姓名、简介、位置、网站URL)
- 关注和取消关注用户
- 列出任何用户或已验证账户的关注者
- 列出用户或已验证账户正在关注的账户
列表管理
- 创建新列表(公开或私有)
- 获取特定列表的信息
- 检索由已验证用户拥有的所有列表
可用的MCP工具
| 工具名称 | 描述 |
|---|---|
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 |
获取已验证用户拥有的所有列表 |
要求
- Node.js 18.x 或更高版本
- 带有API密钥的X开发者账号
- API v1 和 v2 访问权限
环境变量
| 变量 | 描述 |
|---|---|
TWITTER_API_KEY |
您的API密钥 |
TWITTER_API_SECRET |
您的API密钥秘密 |
TWITTER_ACCESS_TOKEN |
您的访问令牌 |
TWITTER_ACCESS_TOKEN_SECRET |
您的访问令牌秘密 |
仓库结构
twitter-mcp/
├── .github/
│ └── workflows/
│ ├── publish.yml
│ └── release.yml
├── code/
│ ├── account_management.py # Sample Python code for account management
│ ├── post_tweet.py # Sample Python code for posting content
│ └── retrieve_tweets.py # Sample Python code for retrieving content
├── src/
│ ├── index.ts # Main entry point
│ ├── twitter-api.ts # X API client
│ ├── formatter.ts # Response formatter
│ └── types.ts # Type definitions
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json
许可证
MIT