使用说明
X MCP服务器
该工具是一个MCP服务器,用于通过MCP客户端(如Claude、Cursor AI、Windsurf AI等)与X平台进行交互。
先决条件
- Node.js(>=18.0.0)
- npm(>=8.0.0)
- X开发人员API密钥
关于X API速率限制的重要说明
- X API的每分钟请求数有一个速率限制,由X平台设置。
- 您可以参考此页面了解限制:https://developer.x.com/en/portal/products
入门指南
-
克隆此存储库:
git clone <repository-url> -
安装依赖项:
npm install -
构建项目:
npm run build这将编译
index.ts文件在src文件夹并创建build目录。
配置
-
您需要您的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
-
设置环境变量: 您必须为您的客户端设置MCP服务器。
-
对于克劳德:
- 打开克劳德桌面
- 转到设置->开发人员
- 在这里,您将看到一个通过单击配置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
-
对于光标AI:
- 您可以按照Cursor文档中的说明进行操作:https://docs.cursor.com/context/model-context-protocol
-
对于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提示输入下方的“刷新服务器”按钮。
-
对于其他MCP客户端:
- 您可以参考MCP官方文件:https://modelcontextprotocol.io/introduction
-
现在,您可以使用首选的MCP客户端在本地连接到此MCP服务器,并与X平台进行交互。
