JinDaGe - x-mcp-server MCP Details

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开发者平台

x-mcp-server