X (Twitter) MCP 服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端（如 Claude 桌面应用）提供与 X (Twitter) 交互的能力。通过此服务器，LLM 可以安全、可控地访问您的 Twitter 账户，执行如查看时间线、发布推文和回复等操作。

主要功能点

获取主页时间线: 让 LLM 能够读取您 Twitter 主页的最新推文。
创建推文: 允许 LLM 代表您发布新的 Twitter 推文。
回复推文: 支持 LLM 回复指定的 Twitter 推文。
速率限制处理: 内置对 Twitter 免费 API 速率限制的处理机制，确保服务的稳定运行。

安装步骤

克隆仓库:

git clone https://github.com/DataWhisker/x-mcp-server.git
cd x-mcp-server

安装依赖:
```
npm install
```
构建服务器:
```
npm run build
```

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude 桌面应用），您需要在客户端的配置文件中添加以下服务器配置信息。请根据您的实际安装路径调整 'args' 中的路径。

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": ["/path/to/x-mcp-server/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "YOUR_TWITTER_API_KEY",
        "TWITTER_API_SECRET": "YOUR_TWITTER_API_SECRET",
        "TWITTER_ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN",
        "TWITTER_ACCESS_SECRET": "YOUR_TWITTER_ACCESS_SECRET"
      }
    }
  }
}

配置参数说明:

'"x"': 服务器名称，客户端通过此名称引用该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行 JavaScript 代码。
'"args": ["/path/to/x-mcp-server/build/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'index.js' 的路径。请将 '/path/to/x-mcp-server' 替换为您的 'x-mcp-server' 仓库的实际路径。
'"env"': 环境变量配置，用于传递 Twitter API 密钥和令牌。
- '"TWITTER_API_KEY"': 您的 Twitter API 密钥 (Consumer Key)。
- '"TWITTER_API_SECRET"': 您的 Twitter API 密钥Secret (Consumer Secret)。
- '"TWITTER_ACCESS_TOKEN"': 您的 Twitter 访问令牌。
- '"TWITTER_ACCESS_SECRET"': 您的 Twitter 访问令牌 Secret。

注意: 您需要在 Twitter开发者平台创建一个应用并获取 API 密钥和令牌，并替换 '"YOUR_TWITTER_API_KEY"' 等占位符。详细步骤请参考仓库 README.md 中的 "Configuration" 部分。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以使用 'use_mcp_tool' 等函数调用此服务器提供的工具。例如，在 Claude 桌面应用中，您可以使用以下代码获取您的 Twitter 主页时间线：

await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 } // 可选参数，限制返回推文数量
});

要创建推文，可以使用 'create_tweet' 工具：

await use_mcp_tool({
  server_name: "x",
  tool_name: "create_tweet",
  arguments: { text: "你好，来自 MCP 服务器的推文！" }
});

更多工具和使用示例请参考仓库 README.md 的 "Available Tools" 部分。

关键词