返回 MCP 目录
public公开dns本地运行

x-mcp-server

这是一个用于通过MCP客户端(如Claude、Cursor AI等)与X平台交互的MCP服务器工具,需要Node.js环境和X开发者API密钥来运行。

article

README

🚀 X MCP 服务器

此工具是一个MCP服务器,可借助MCP客户端(像Claude、Cursor AI、Windsurf AI等)实现与X平台的交互。

🚀 快速开始

先决条件

  • Node.js(版本需 >=18.0.0)
  • npm(版本需 >=8.0.0)
  • X开发者API密钥

克隆仓库

git clone <repository-url>

安装依赖

npm install

构建项目

npm run build

此操作会对src文件夹里的index.ts文件进行编译,并创建build目录。

配置

1. 获取API密钥

您需要用到X开发者API密钥来使用此工具,具体需要以下4个密钥/令牌:

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

若您不清楚如何获取这些密钥/令牌,可参考X开发人员网站上的说明:获取X API访问权限

2. 设置环境变量

您需要为客户端配置MCP服务器,以下是不同客户端的配置方法:

Claude
  • 打开Claude桌面应用。
  • 进入设置 -> 开发者选项。
  • 在此处,您会看到配置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桌面应用。
  • 您可参考Anthropic的官方文档了解MCP服务器设置:MCP服务器快速入门
Cursor AI

按照Cursor文档中的说明操作:Cursor MCP协议文档

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"
            }
        }
    }
}
  • 保存文件后,点击下方的“刷新服务器”按钮。
其他MCP客户端

您可参考官方MCP文档:MCP协议介绍

完成上述步骤后,您就可以使用首选的MCP客户端本地连接到此MCP服务器,并与X平台进行交互啦。

⚠️ 重要提示

  • X平台对API请求设置了每分钟的速率限制。
  • 有关详细信息,请参阅:X开发者平台
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端