使用说明

项目简介

vidhupv_x-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端（如 Claude）提供与 X (Twitter) 平台交互的能力。通过这个服务器，用户可以使用自然语言命令，直接通过 LLM 客户端来创建、管理和发布 X (Twitter) 帖子，包括单条推文和推文线程。它简化了社交媒体内容创作和管理流程，使得用户可以通过对话式交互完成 Twitter 操作。

主要功能点

草稿管理：允许用户创建和保存推文草稿和线程草稿，方便用户在发布前编辑和预览内容。
推文发布：支持将草稿发布到 X (Twitter) 平台，包括发布单条推文和由多条推文组成的线程。
草稿列表：提供查看所有已保存草稿的功能，方便用户管理和选择要发布的草稿。
草稿删除：允许用户删除不再需要的草稿。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/vidhupv_x-mcp.git
cd vidhupv_x-mcp

安装 UV: 按照仓库 README 建议，全局安装 'uv'。如果你的系统已安装，可以跳过此步骤。
```
brew install uv
```
如果 'brew' 未安装，请根据 uv installation guide 选择合适的方式安装。
配置 Claude 客户端: 根据你的操作系统，创建 'claude_desktop_config.json' 文件，并添加服务器配置信息。
- MacOS: 打开目录 '~/Library/Application Support/Claude/' 并创建文件。
- Windows: 打开目录 '%APPDATA%/Claude/' 并创建文件。

添加服务器配置到 'claude_desktop_config.json': 将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中。请根据实际情况修改路径和 API 密钥。

{
  "mcpServers": {
    "x_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/vidhupv_x-mcp",  // 替换为你的仓库路径
        "run",
        "src/x_mcp/server.py"      // 执行服务器脚本
      ],
      "env": {
        "TWITTER_API_KEY": "YOUR_TWITTER_API_KEY",          // 替换为你的 Twitter API 密钥
        "TWITTER_API_SECRET": "YOUR_TWITTER_API_SECRET",    // 替换为你的 Twitter API 密钥密文
        "TWITTER_ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN",  // 替换为你的 Twitter 访问令牌
        "TWITTER_ACCESS_TOKEN_SECRET": "YOUR_TWITTER_ACCESS_TOKEN_SECRET" // 替换为你的 Twitter 访问令牌密文
      }
    }
  }
}

配置参数说明:

'"x_mcp"': 服务器名称，在 Claude 客户端中用于标识和选择该服务器。
'"command": "uv"': 运行服务器的命令，这里使用全局安装的 'uv'。你也可以替换为 'python' 或其他 Python 运行环境命令，如果 'uv' 没有全局安装，请使用 'uv' 的完整路径。
'"args"': 传递给 'command' 的参数列表。
- '"--directory", "/path/to/vidhupv_x-mcp"': 指定服务器脚本所在的目录，请替换为你的 'vidhupv_x-mcp' 仓库的实际路径。
- '"run", "src/x_mcp/server.py"': 使用 'uv run' 命令运行 'src/x_mcp/server.py' 脚本，启动 MCP 服务器。
'"env"': 设置服务器运行所需的环境变量。
- '"TWITTER_API_KEY"', '"TWITTER_API_SECRET"', '"TWITTER_ACCESS_TOKEN"', '"TWITTER_ACCESS_TOKEN_SECRET"': 必须替换为你在 X (Twitter) 开发者平台申请的 API 密钥和令牌。

获取 X (Twitter) API 凭据:
- 访问 X API Developer Portal。
- 创建一个新的项目。
- 在 "User Authentication Settings" 中，配置为 "Read and Write permissions" 和 "Web App type"。
- 设置 "Callback URL" 为 'http://localhost/'，"Website URL" 为 'http://example.com/'。
- 在 "Keys and Tokens" 部分生成并复制 API 密钥和令牌。
更新配置文件:
- 将 'claude_desktop_config.json' 中的 '/path/to/vidhupv_x-mcp' 替换为你的仓库实际路径。
- 将 'YOUR_TWITTER_API_KEY' 等占位符替换为你获取的 X (Twitter) API 凭据。
重启 Claude 客户端: 完全退出 Claude 客户端并重新打开，使配置生效。

基本使用方法

配置完成后，在 Claude 客户端中，你可以使用以下自然语言指令来操作 X (Twitter):

创建推文草稿: 例如，你可以输入 'Tweet '今天天气真好！'' 或 'Create a draft tweet with content '今天天气真好！''。
创建推文线程草稿: 例如，你可以输入 'Create a thread about 2024 巴黎奥运会'。
列出草稿: 输入 'Show me my draft tweets' 或 'List drafts'。
发布草稿: 输入 'Publish draft draft_1678886400.json' (假设 'draft_1678886400.json' 是你要发布的草稿 ID)。
删除草稿: 输入 'Delete draft thread_draft_1678889900.json' (假设 'thread_draft_1678889900.json' 是你要删除的草稿 ID)。

注意: 草稿 ID 是在创建草稿时返回的，或者可以通过列出草稿来查看。请根据实际的草稿 ID 进行发布和删除操作。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息