使用说明
项目简介
X(Twitter) MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为大型语言模型 (LLM) 客户端(如 Claude)提供与 X(Twitter) 平台交互的能力。通过此服务器,用户可以直接在 Claude 等客户端中创建草稿推文、发布推文、创建推文线程、查看草稿和删除草稿。
主要功能点
- 创建草稿推文和线程: 允许用户通过自然语言指令创建推文和推文线程的草稿,方便用户预先构思内容。
- 列出草稿: 用户可以查看所有已保存的草稿推文和线程,方便管理和选择要发布的内容。
- 发布草稿: 支持将草稿推文或线程发布到 X(Twitter) 平台,直接将预先准备的内容发布出去。
- 删除草稿: 允许用户删除不再需要的草稿,保持草稿箱的整洁。
安装步骤
- 克隆仓库到本地:
git clone https://github.com/vidhupv/x-mcp.git - 安装 'uv' (如果尚未安装): 按照仓库 README 中的 "Manual Installation" 指引进行安装。
- 获取 X/Twitter API 密钥: 按照仓库 README 中的 "5. Get your X/Twitter API credentials" 指引,在 X 开发者平台创建项目并获取 API 密钥、密钥Secret、访问令牌和访问令牌 Secret。
- 配置 'claude_desktop_config.json': 根据仓库 README 中的 "3. Create claude_desktop_config.json" 和 "4. Add this configuration to claude_desktop_config.json" 指引,创建并编辑 'claude_desktop_config.json' 文件,填入服务器配置信息和 X/Twitter API 密钥。
服务器配置
以下 JSON 配置信息需要添加到 MCP 客户端(例如 Claude)的配置文件中,以便客户端连接到 X(Twitter) MCP 服务器。请将 '/path/to/x-mcp' 替换为实际的仓库路径。
{ "mcpServers": { "x_mcp": { "command": "uv", "args": [ "--directory", "/path/to/x-mcp", // 替换为 x-mcp 仓库的实际路径 "run", "src/x_mcp/server.py" // 运行服务器的 Python 脚本 ], "env": { "TWITTER_API_KEY": "YOUR_TWITTER_API_KEY", // 替换为你的 Twitter API Key "TWITTER_API_SECRET": "YOUR_TWITTER_API_SECRET", // 替换为你的 Twitter API Secret "TWITTER_ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN", // 替换为你的 Twitter Access Token "TWITTER_ACCESS_TOKEN_SECRET": "YOUR_TWITTER_ACCESS_TOKEN_SECRET" // 替换为你的 Twitter Access Token Secret } } } }
基本使用方法
配置完成后,在 Claude 等 MCP 客户端中,你可以使用自然语言指令来调用 X(Twitter) MCP 服务器提供的工具,例如:
- 在 Claude 中输入 'Tweet '你的推文内容'' 来创建一个推文草稿。
- 使用 'Create a thread about ...' 来创建推文线程草稿。
- 使用 'Show me my draft tweets' 来查看草稿列表。
- 使用 'Publish this draft!' 并指定草稿 ID 来发布草稿。
- 使用 'Delete that draft' 并指定草稿 ID 来删除草稿。
信息
分类
通信与社交