使用说明

项目简介

X(Twitter) MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为大型语言模型 (LLM) 客户端(如 Claude)提供与 X(Twitter) 平台交互的能力。通过此服务器,用户可以直接在 Claude 等客户端中创建草稿推文、发布推文、创建推文线程、查看草稿和删除草稿。

主要功能点

  • 创建草稿推文和线程: 允许用户通过自然语言指令创建推文和推文线程的草稿,方便用户预先构思内容。
  • 列出草稿: 用户可以查看所有已保存的草稿推文和线程,方便管理和选择要发布的内容。
  • 发布草稿: 支持将草稿推文或线程发布到 X(Twitter) 平台,直接将预先准备的内容发布出去。
  • 删除草稿: 允许用户删除不再需要的草稿,保持草稿箱的整洁。

安装步骤

  1. 克隆仓库到本地:
    git clone https://github.com/vidhupv/x-mcp.git
  2. 安装 'uv' (如果尚未安装): 按照仓库 README 中的 "Manual Installation" 指引进行安装。
  3. 获取 X/Twitter API 密钥: 按照仓库 README 中的 "5. Get your X/Twitter API credentials" 指引,在 X 开发者平台创建项目并获取 API 密钥、密钥Secret、访问令牌和访问令牌 Secret。
  4. 配置 '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 来删除草稿。

信息

分类

通信与社交