X MCP Server

X MCP 服务

这是一个 MCP 服务，可通过 Claude、Cursor AI、Windsurf AI 等 MCP 客户端与 X 平台交互。

前置条件

1. Node.js（>=18.0.0）
2. npm（>=8.0.0）
3. X Developer API 密钥

关于 X API 速率限制的重要说明

• X 平台对 X API 每分钟的请求数量设有限制。
• 请参阅此页面了解限制：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 Developer API 密钥来使用此工具。你需要以下 4 个密钥/令牌：

   • X API Key
   • X API Key Secret
   • X Access Token
   • X Access Token Secret

   如果你不清楚如何获取这些密钥/令牌，可以按照 X Developer 网站上的说明操作：https://developer.twitter.com/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api

2. 设置环境变量： 你需要为客户端配置 MCP 服务。

   1. 对于 Claude：

      • 打开 Claude Desktop
      • 转到 Settings -> Developer
      • 点击 Edit Config，即可看到配置 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。
      • MCP 服务的设置方法请参阅 Anthropic 官方文档：https://modelcontextprotocol.io/quickstart/server

   2. 对于 Cursor AI：

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

   3. 对于 Windsurf AI：

      • 在 Cascade 中开启新的聊天。
      • 你应该会在 Cascade 提示词输入框下方看到 Configure 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 提示词输入框下方的 Refresh servers 按钮。

   4. 对于其他 MCP 客户端：

      • 请参阅 MCP 官方文档：https://modelcontextprotocol.io/introduction

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