MCP 服务器

X (Twitter) MCP Server

可以与 X (前身为 Twitter) 互动，允许发布推文、搜索内容、管理帐户和组织列表。

README

<img src="https://www.x.com/favicon.ico" alt="X Logo" width="32" height="32"> 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 文件：

# 创建一个包含您的 X API 密钥的 .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。

Claude 配置

要将此服务器与 Claude 一起使用，您需要设置 MCP 配置。以下是配置结构应如下所示的示例：

{
  "name": "x",
  "display_name": "X",
  "description": "X MCP 允许 Claude 与 X (前身为 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  # 用于帐户管理的示例 Python 代码
│   ├── post_tweet.py          # 用于发布内容的示例 Python 代码
│   └── retrieve_tweets.py     # 用于检索内容的示例 Python 代码
├── src/
│   ├── index.ts        # 主要入口点
│   ├── twitter-api.ts  # X API 客户端
│   ├── formatter.ts    # 响应格式化程序
│   └── types.ts        # 类型定义
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json