项目简介

'twitter-mcp-server' 是一个基于 Model Context Protocol (MCP) 构建的Twitter客户端服务器。它允许大型语言模型 (LLM) 通过标准化的接口与Twitter平台进行交互,提供推文读取、发布、点赞、关注等功能。用户只需连接其Twitter账户或提供认证令牌,即可利用LLM驱动的智能体轻松管理和操作Twitter。

主要功能点

  • 推文读取: 获取指定用户的最新推文、搜索推文(按话题或关键词)、查看时间线(主页、关注者、用户时间线)、获取Twitter列表的推文。
  • 用户和趋势: 获取用户资料详情、查看用户的关注者或关注列表、获取当前Twitter热门趋势。
  • 推文互动: 对推文进行点赞/取消点赞、转发/取消转发。
  • 内容发布: 发布新推文(支持媒体附件、回复、引用推文)、创建Twitter帖子串(Thread)。
  • 用户管理: 关注/取消关注其他Twitter用户。

安装步骤

  1. 安装Docker: 确保您的系统已安装Docker。
  2. 拉取镜像: 该服务器以Docker镜像形式提供,无需手动安装代码。
  3. 配置认证信息: 在运行服务器时,您需要提供Twitter认证令牌('auth_token'和'ct0')。这些信息通常通过环境变量或在启动命令中传递。例如,在使用HTTP模式时,MCP客户端会在'Authorization'头中发送这些信息。

服务器配置

此MCP服务器作为插件集成到您的MCP客户端中。以下是一个MCP客户端的配置示例,您可以将其添加到Claude桌面版等MCP客户端的配置文件中:

  • MacOS路径: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows路径: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容示例: 请将以下'twitter-mcp-server'服务器的配置添加到您的MCP客户端配置文件中的'mcpServers'对象内。

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name", "twitter-mcp-server",
        "touchmeangel/twitter-mcp-server"
      ],
      "description": "连接Twitter账号,为LLM提供实时推文获取、互动、管理等能力的MCP服务器。",
      "icon": "https://example.com/twitter-icon.png" // 可选,可替换为Twitter图标的实际URL
    }
  }
}

参数注释:

  • '"twitter-mcp-server"': 这是您为该服务器定义的唯一名称,MCP客户端将通过此名称识别并连接。
  • '"command": "docker"': 指定启动服务器的命令是'docker'。
  • '"args"': 启动命令的参数列表。
    • '"run"': Docker命令,用于运行容器。
    • '"-i"': 保持标准输入打开,即使不附着。这对于与MCP客户端的Stdio通信很重要。
    • '"--rm"': 容器退出时自动删除。
    • '"--name", "twitter-mcp-server"': 为运行的Docker容器指定名称。
    • '"touchmeangel/twitter-mcp-server"': 要运行的Docker镜像名称。
  • (可选) 如果您希望以HTTP模式运行服务器,可以在'args'中添加环境变量和端口映射:
    "args": [
      "run",
      "-i",
      "--rm",
      "--name", "twitter-mcp-server",
      "-e", "APP_PORT=3000", // 设置服务器运行的端口
      "-p", "3000:3000",     // 将容器端口映射到主机端口
      "touchmeangel/twitter-mcp-server"
    ]
    在HTTP模式下,MCP客户端会通过HTTP协议连接,而不是Stdio。

基本使用方法

配置完成后,您的MCP客户端(如Claude桌面版)将能够自动检测并连接到 'twitter-mcp-server'。当LLM需要执行与Twitter相关的操作时,它会通过MCP协议调用该服务器提供的工具(例如 'get_tweets' 或 'post_tweet')。您需要在LLM交互时提供必要的Twitter认证信息,以便服务器能够代表您执行操作。

信息

分类

通信与社交