项目简介
'twitter-mcp-server' 是一个基于 Model Context Protocol (MCP) 构建的Twitter客户端服务器。它允许大型语言模型 (LLM) 通过标准化的接口与Twitter平台进行交互,提供推文读取、发布、点赞、关注等功能。用户只需连接其Twitter账户或提供认证令牌,即可利用LLM驱动的智能体轻松管理和操作Twitter。
主要功能点
- 推文读取: 获取指定用户的最新推文、搜索推文(按话题或关键词)、查看时间线(主页、关注者、用户时间线)、获取Twitter列表的推文。
- 用户和趋势: 获取用户资料详情、查看用户的关注者或关注列表、获取当前Twitter热门趋势。
- 推文互动: 对推文进行点赞/取消点赞、转发/取消转发。
- 内容发布: 发布新推文(支持媒体附件、回复、引用推文)、创建Twitter帖子串(Thread)。
- 用户管理: 关注/取消关注其他Twitter用户。
安装步骤
- 安装Docker: 确保您的系统已安装Docker。
- 拉取镜像: 该服务器以Docker镜像形式提供,无需手动安装代码。
- 配置认证信息: 在运行服务器时,您需要提供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'中添加环境变量和端口映射:
在HTTP模式下,MCP客户端会通过HTTP协议连接,而不是Stdio。"args": [ "run", "-i", "--rm", "--name", "twitter-mcp-server", "-e", "APP_PORT=3000", // 设置服务器运行的端口 "-p", "3000:3000", // 将容器端口映射到主机端口 "touchmeangel/twitter-mcp-server" ]
基本使用方法
配置完成后,您的MCP客户端(如Claude桌面版)将能够自动检测并连接到 'twitter-mcp-server'。当LLM需要执行与Twitter相关的操作时,它会通过MCP协议调用该服务器提供的工具(例如 'get_tweets' 或 'post_tweet')。您需要在LLM交互时提供必要的Twitter认证信息,以便服务器能够代表您执行操作。
信息
分类
通信与社交