x-twitter-mcp-server

🚀 X Twitter 管理控制面板 (MCP) 服务器文档

X Twitter MCP 服务器是一款管理与控制 Twitter 平台的实用工具，具备丰富功能，可助力用户实现 Twitter 使用体验的自动化与优化。本指南将详细阐述该服务器的安装、配置及使用方法，同时提供故障排除等实用信息。

🚀 快速开始

若你想快速上手 X Twitter MCP 服务器，可参考后续的安装与启动步骤。

✨ 主要特性

• 用户管理：提供 get_timeline、get_latest_timeline、search_twitter、get_trends 等接口，方便获取用户主页时间线、关注时间线、搜索 Twitter 以及获取热门话题。
• Tweet 操作：支持 favorite_tweet、unfavorite_tweet、bookmark_tweet、delete_bookmark、delete_all_bookmarks 等操作，可对推文进行点赞、取消点赞、添加书签等操作。
• 搜索与趋势：通过 search_twitter 可使用查询词搜索 Twitter，get_trends 能获取当前最多前 10 个流行话题。

📦 安装指南

安装方式

方式一：从源代码安装

1. 克隆 GitHub 仓库。
2. 打开终端，进入克隆后的文件夹。
3. 运行以下命令以安装依赖项：

pip install -r requirements.txt

4. 编辑 .env 文件并填充你的 Twitter API 凭证。

方式二：使用 PyPI 安装

1. 在终端中运行以下命令：

pip install x-twitter-mcp-server

2. 配置环境变量，参考 claude_desktop_config.json。

启动服务器

1. 打开终端，导航到安装目录。
2. 运行启动脚本：

python -m x_twitter_mcp_server

💻 使用示例

基础用法

以下是一些使用 X Twitter MCP 服务器的基础代码示例：

# 获取用户的主页时间线
from x_twitter_mcp_server import get_timeline
timeline = get_timeline()
print(timeline)

# 点赞一条推文
from x_twitter_mcp_server import favorite_tweet
favorite_tweet(tweet_id=123456789)

高级用法

# 使用查询词搜索 Twitter，限制结果数量为 20
from x_twitter_mcp_server import search_twitter
search_results = search_twitter(query="example", limit=20)
print(search_results)

📚 详细文档

功能概述

X Twitter MCP 服务器提供了多种功能模块，包括用户管理、Tweet 操作、搜索与趋势等。

用户管理

| 接口名称 | 功能描述 | | ---- | ---- | | get_timeline | 获取用户的主页时间线 | | get_latest_timeline | 获取用户关注的时间线 | | search_twitter | 根据查询词搜索 Twitter | | get_trends | 获取当前 Twitter 趋势话题 |

Tweet 操作

| 接口名称 | 功能描述 | | ---- | ---- | | favorite_tweet | 点赞一条推文 | | unfavorite_tweet | 取消点赞一条推文 | | bookmark_tweet | 将推文添加到书签 | | delete_bookmark | 从书签中删除推文 | | delete_all_bookmarks | 删除所有书签 |

搜索与趋势

| 接口名称 | 功能描述 | | ---- | ---- | | search_twitter | 使用查询词搜索 Twitter，限制结果数量（默认为 10） | | get_trends | 获取最多前 10 个当前流行的话题 |

🔧 技术细节

故障排除

服务器无法启动

1. 确保 .env 文件包含所有必要的 Twitter API 凭证（适用于从源代码安装的情况）。
2. 对于使用 PyPI 安装的用户，确认环境变量已在 claude_desktop_config.json 或 shell 中设置。
3. 在终端中查看启动日志以获取错误信息。
4. 确保 uv 或 Python 可执行文件正确安装且可访问。

Claude 未检测到服务器

1. 核查 claude_desktop_config.json 中的路径是否正确。
2. 确认命令和参数指向正确的可执行文件和脚本。
3. 更新配置文件后重启 Claude Desktop。
4. 启用开发者模式，查看日志文件以获取更多错误信息。

速率限制错误

• 服务器已集成速率限制处理机制。如果遇到 Twitter API 的速率限制，请等待重置窗口时间（例如：tweet 操作为 15 分钟）。

语法警告

• 如果出现 SyntaxWarning 提示，通常是由于代码兼容性问题引起的，建议检查并更新相关依赖项。

📄 许可证

本项目遵循 MIT 许可证，具体内容请参阅 LICENSE 文件。

🌟 贡献方式

欢迎贡献！如果希望为项目做出贡献，请参考 GitHub 仓库 中的 CONTRIBUTING 文件。