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

简介

X Twitter MCP 服务器是一个用于管理和控制 Twitter 平台的工具，提供了丰富的功能来帮助用户自动化和优化他们的 Twitter 使用体验。本指南将详细介绍如何安装、配置和使用该服务器，并提供故障排除和其他有用的信息。

安装指南

安装方式

方式一：从源代码安装

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 服务器提供了多种功能模块，包括用户管理、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 提示，通常是由于代码兼容性问题引起的，建议检查并更新相关依赖项。

贡献方式

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

许可证

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