使用说明
X MCP
一个MCP服务器,让人工智能助手直接访问X/Twitter——搜索推文、发布内容、管理线程和检索用户配置文件。
为真实的工作流程而构建:监控对话、发布线程,并在不离开人工智能助手的情况下从X收集情报。
可用工具
推文
- x_search_tweets -使用Twitter搜索语法搜索最近的推文
- x_get_tweet -按ID获取包含完整细节和指标的特定推文
- x_post_tweet -发布新推文或回复现有推文
- x_post_线程 -发布多条推文(推文之间用
|||) - x_删除_推特 -删除您发布的推文
- x_get_quote_weets -获取引用特定推文的推文
参与
- x-like_tweet -像推特一样
- x_不喜欢_推特 -与推特不同
- X转发 -转发推特
- x_未发布 -撤销转发
用户
- x_get_user -按用户名获取用户配置文件信息
- x_get_user_timeline -从用户的时间轴获取最近的推文
- x_get_mentions -获取最近提及用户的推文
列表
- x_get_user_lists -获取用户拥有的列表
- x_get_list_tweets -从列表中获取最近的推文
节制
- x_mute_user -将用户静音
- x_unmute_user -取消用户静音
- x_block_user -阻止用户
- x_解锁用户 -解除用户锁定
安装
将此提示复制到您的AI助手:
Install the X MCP server (https://github.com/nguyenvanduocit/x-mcp) for my Claude Desktop or Cursor IDE. Read the MCP documentation carefully and guide me through the installation step by step.
如果您的AI助手无法帮助进行此安装,则表示配置错误或AI工具无效。一个有能力的AI助手应该能够指导您完成MCP安装。
快速启动
1) 获取API凭据
在以下位置创建密钥 X开发者门户.
2) 添加到光标
二进制
{
"mcpServers": {
"x": {
"command": "x-mcp",
"args": ["-env", "/path/to/your/.env"],
"env": {
"X_API_KEY": "your-api-key",
"X_API_SECRET": "your-api-secret",
"X_ACCESS_TOKEN": "your-access-token",
"X_ACCESS_TOKEN_SECRET": "your-access-token-secret"
}
}
}
}
安装二进制文件:
go install github.com/nguyenvanduocit/x-mcp@latest
3) 添加到克劳德代码
claude mcp add x-mcp -- x-mcp -env /path/to/your/.env
4) 试试看
- “搜索上周关于golang的推文”
- “发布一条推特,说X MCP的你好!”
- “获取elonmusk的用户配置文件”
- “发布一条关于Go前三大功能的帖子”
- “喜欢这条推文:123456789”
- “获取我最近提到的内容”
- “将用户@垃圾邮件发送者静音”
- “显示我的‘技术新闻’列表中的推文”
配置
所需的环境变量:
- X_API_键 -您的X API密钥
- X_API_SECRET公司 -您的X API秘密
- X_ACCESS_TOKEN -您的X访问令牌
- X_ACCESS_TOKEN_SECRET -您的X访问令牌密钥
可选:
- PROXY_URL -HTTP代理URL(例如。,
http://localhost:8080)
.env 文件示例:
X_API_KEY=your-api-key
X_API_SECRET=your-api-secret
X_ACCESS_TOKEN=your-access-token
X_ACCESS_TOKEN_SECRET=your-access-token-secret
HTTP模式(可选,用于调试):
x-mcp -env .env -http_port 8080
验证凭据
git clone https://github.com/nguyenvanduocit/x-mcp.git
cd x-mcp
go run scripts/verify-token/main.go \
-api-key=$X_API_KEY \
-api-secret=$X_API_SECRET \
-access-token=$X_ACCESS_TOKEN \
-access-token-secret=$X_ACCESS_TOKEN_SECRET
CLI使用情况
除了MCP服务器之外, x-mcp 提供独立的CLI二进制文件(x-cli)用于直接终端使用——不需要MCP客户端。
安装
just install-cli
# or
go install github.com/nguyenvanduocit/x-mcp/cmd/x-cli@latest
快速开始
export X_API_KEY=your-api-key
export X_API_SECRET=your-api-secret
export X_ACCESS_TOKEN=your-access-token
export X_ACCESS_TOKEN_SECRET=your-access-token-secret
# or
x-cli --env .env <command> [flags]
命令
| 命令 | 描述 |
|---|---|
post-tweet |
发布新推文 |
delete-tweet |
删除推文 |
search |
搜索推文 |
get-user |
获取用户资料 |
get-user-timeline |
获取用户的时间线 |
post-thread |
发布帖子 |
like-tweet |
像推特一样 |
unlike-tweet |
与推特不同 |
retweet |
转发推特 |
unretweet |
撤销转发 |
get-mentions |
获得提及 |
mute-user |
将用户静音 |
block-user |
阻止用户 |
示例
# Post a tweet
x-cli post-tweet --text "Hello from x-cli!"
# Search tweets
x-cli search --query "golang MCP" --max-results 10
# Get user info
x-cli get-user --username myusername
# Like a tweet
x-cli like-tweet --tweet-id 1234567890
# JSON output
x-cli search --query "golang" --output json | jq '.[].text'
旗帜
每个命令都接受:
--env string--通往.env文件--output string--输出格式:text(默认)或json
许可证
麻省理工学院
安装
自制(macOS/Linux)
brew install nguyenvanduocit/tap/x-mcp
修复:触发PR创建后的发布处理权限修复