MCP服务器

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

  • by siddheshutd
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 siddheshutd/x-mcp-server

使用说明

X MCP服务器

该工具是一个MCP服务器,用于通过MCP客户端(如Claude、Cursor AI、Windsurf AI等)与X平台进行交互。

先决条件

  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
    

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

配置

  1. 您需要您的X Developer API密钥才能使用此工具。您将需要这4个密钥/令牌:

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

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

  2. 设置环境变量: 您必须为您的客户端设置MCP服务器。

    1. 对于克劳德:

      • 打开克劳德桌面
      • 转到设置->开发人员
      • 在这里,您将看到一个通过单击配置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"
                }
            }
        }
        
      • 保存配置文件。
      • 重新启动克劳德桌面。
      • 您可以参考Anthropic官方文档来设置MCP服务器https://modelcontextprotocol.io/quickstart/server
    2. 对于光标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平台进行交互。