X MCP 服务器

此工具是一个通过如 Claude、Cursor AI、Windsurf AI 等 MCP 客户端与 X 平台交互的 MCP 服务器。

预备条件

1. Node.js (>=18.0.0)
2. npm (>=8.0.0)
3. X 开发者 API 密钥

关于 X API 的速率限制的重要注意事项

• X API 对每分钟请求的数量有限制，该限制由 X 平台设定。
• 您可以参考此页面了解限制详情：https://developer.x.com/en/portal/products

快速开始

1. 克隆此仓库：

   git clone <repository-url>
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

   这将编译 src 文件夹中的 index.ts 文件，并创建 build 目录。

配置

1. 使用此工具需要您的 X 开发者 API 密钥。您需要以下 4 个密钥/令牌：

   • X API 密钥
   • X API 密钥秘密
   • X 访问令牌
   • X 访问令牌秘密

   如果您不知道如何获取这些密钥/令牌，您可以按照 X 开发者网站上的说明进行操作：https://developer.twitter.com/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api

2. 设置环境变量： 您需要为您的客户端设置 MCP 服务器。

   1. 对于 Claude：

      • 打开 Claude Desktop
      • 前往设置 -> 开发者
      • 在这里，您会看到一个选项来配置 MCP 服务器，点击它（编辑配置）
      • Claude 将打开包含配置文件的文件夹。打开名为 claude_desktop_config.json 的配置文件。
      • 添加以下配置：

        {
            "x-mcp-server": {
                "command": "node",
                "args": [
                    "/ABSOLUTE/PATH/TO/PARENT/FOLDER/x-mcp-server/build/index.js"
                ],
                "env": {
                    "X_API_KEY": "your-x-api-key",
                    "X_API_KEY_SECRET": "your-x-api-key-secret",
                    "X_ACCESS_TOKEN": "your-x-access-token",
                    "X_ACCESS_TOKEN_SECRET": "your-x-access-token-secret"
                }
            }
        }
        

      • 保存配置文件。
      • 重启 Claude Desktop。
      • 您可以参考官方 Anthropic 文档来设置 MCP 服务器 https://modelcontextprotocol.io/quickstart/server

   2. 对于 Cursor AI：

      • 您可以按照 Cursor 文档中的说明进行操作：https://docs.cursor.com/context/model-context-protocol

   3. 对于 Windsurf AI：

      • 在 Cascade 中打开一个新的聊天窗口。
      • 您应该会在 Cascade 提示输入框下方看到一个配置 MCP 的按钮，点击它。
      • 它将在编辑器中打开配置文件，您可以添加以下配置：

        {
            "mcpServers": {
                "x-mcp-server": {
                    "command": "node",
                    "args": [
                        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/x-mcp-server/build/index.js"
                    ],
                    "env": {
                        "X_API_KEY": "your-x-api-key",
                        "X_API_KEY_SECRET": "your-x-api-key-secret",
                        "X_ACCESS_TOKEN": "your-x-access-token",
                        "X_ACCESS_TOKEN_SECRET": "your-x-access-token-secret"
                    }
                }
            }
        }
        

      • 保存文件并点击 Cascade 提示输入框下方的刷新服务器按钮。

   4. 对于其他 MCP 客户端：

      • 您可以参考官方 MCP 文档：https://modelcontextprotocol.io/introduction

现在，您可以使用首选的 MCP 客户端连接到此本地 MCP 服务器并与 X 平台进行交互。