X/Twitter管理服务器

一个为AI助手提供直接访问X/Twitter功能的服务器,支持搜索推文、发布内容、管理线程和检索用户资料。

  • by nguyenvanduocit
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nguyenvanduocit/x-mcp

使用说明

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创建后的发布处理权限修复