Twitter MCP Server 使用说明

项目简介

Twitter MCP Server 是一个基于 Model Context Protocol (MCP) 标准构建的服务器，旨在为 AI Agent 提供访问和操作 Twitter (X) 平台的桥梁。通过标准化的 MCP 接口，AI Agent 可以安全、便捷地调用 Twitter 的各项功能，实现更丰富的应用场景。

主要功能点

推文读取: 获取用户推文、用户个人资料、搜索推文（按关键词或话题标签）。
用户互动: 点赞、取消点赞、转发、取消转发推文。
推文发布: 发布新推文，支持文本、图片、视频、回复和引用推文。
高级功能: 获取用户关系（粉丝、关注列表）、获取趋势话题、访问不同类型的时间线（首页、关注、用户时间线）、列表管理。
媒体处理: 支持图片和视频上传，以及为媒体添加Alt Text。
推文串创建: 创建推文串（Thread）。
用户管理: 关注和取消关注用户。

安装步骤

安装依赖: 确保已安装 Node.js 和 npm，然后在项目根目录下运行命令安装项目依赖：
```
npm install
```
构建服务器: 运行命令构建服务器代码：
```
npm run build
```
配置环境变量: 根据需要配置以下环境变量，用于 Twitter 账号认证。
- 'TWITTER_USERNAME': Twitter 用户名 (用于用户密码登录，如果使用API Key登录则不需要)
- 'TWITTER_PASSWORD': Twitter 密码 (用于用户密码登录，如果使用API Key登录则不需要)
- 'TWITTER_EMAIL': Twitter 邮箱 (用于用户密码登录，如果使用API Key登录则不需要)
- 'TWITTER_API_KEY': Twitter API Key (可选，用于API Key登录)
- 'TWITTER_API_SECRET_KEY': Twitter API Secret Key (可选，用于API Key登录)
- 'TWITTER_ACCESS_TOKEN': Twitter Access Token (可选，用于API Key登录)
- 'TWITTER_ACCESS_TOKEN_SECRET': Twitter Access Token Secret (可选，用于API Key登录)

服务器配置

将以下配置添加到你的 MCP 客户端配置文件中 (例如 Claude 客户端的 'claude_desktop_config.json')。请根据你的实际项目路径修改 'command' 字段。

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

'server name': 'twitter-mcp-server' (服务器名称，用于在MCP客户端中标识和引用)
'command': '/path/to/twitter-mcp-server/build/index.js' (服务器启动命令，指向构建后的 'index.js' 文件。请替换为实际路径)

基本使用方法

启动 Twitter MCP Server (通常在配置完成后，MCP客户端会自动启动).
在支持 MCP 协议的 AI Agent 中，可以使用提供的 Tools 来访问 Twitter 功能。例如，使用 'get_tweets' 工具获取指定用户的推文，或使用 'post_tweet' 工具发布新的推文。
详细的工具列表和参数说明请参考仓库的 README.md 文件或 'ListTools' MCP 请求。

关键词