Twitter客户端MCP服务

一个通过`agent-twitter-client`库提供安全访问Twitter功能的模型上下文协议(MCP)服务器,适用于需要安全集成Twitter功能的开发场景。

  • by mzkrasner
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 mzkrasner/twitter-client-mcp

使用说明

Twitter客户端MCP

一种模型上下文协议(MCP)服务器,通过 agent-twitter-client 图书馆。

特性

Twitter客户端MCP提供以下功能:

  • 配置文件操作

    • 按用户名获取个人资料信息
    • 获取经过身份验证的用户的个人资料
  • 推特操作

    • 按ID获取特定推文
    • 获取用户的推文
    • 发送新推文
    • 喜欢推特
    • 转发推文
  • 搜索操作

    • 搜索推文
    • 搜索个人资料
  • 关系运营

    • 获取用户的关注者
    • 获取用户正在关注的用户
    • 关注用户

安全⚠️

重要提示:TWITTER凭据保护

此MCP服务器需要Twitter凭据才能运行。要保护这些敏感凭据,请执行以下操作:

  1. 切勿共享您的凭据
  2. 切勿运行显示您凭据的命令
  3. 绝不允许LLM直接执行shell命令 未经您批准

多层保护

此服务器实施了几层安全措施来保护您的凭据安全:

1.凭证隔离

  • 您的凭据仅在初始化期间加载
  • 加载后,凭据会立即从环境变量中删除
  • 凭据从不记录或传输到LLM

2.内存保护

  • 使用钠原生安全内存分配
  • 内存锁定以防止交换到磁盘
  • 使用后清空内存缓冲区

3.防止进入

  • 安全的环境变量处理
  • 严格验证所需的环境变量
  • 控制台输出净化,防止泄露机密

设置

  1. 克隆存储库
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    npm run build
    

所需的环境变量

Twitter客户端MCP需要以下环境变量:

TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email@example.com

您可以选择添加Twitter API v2凭据以获得高级功能:

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_secret

工具

服务器公开了以下MCP工具:

工具名称 描述 参数
profileByUsername 按用户名获取推特个人资料 username:字符串
myProfile 获取经过身份验证的用户的个人资料 check:布尔值
getTweet 按ID获取特定推文 tweetId:字符串
getUserTweets 获取推特用户的推文 username:字符串, count?:编号
sendTweet 发布新推文 text:字符串, inReplyToId?:字符串
likeTweet 像推特一样 tweetId:字符串
retweet 转发推特 tweetId:字符串
searchTweets 搜索推文 query:字符串, count?:编号, searchMode?:字符串('顶部','最新','照片','视频')
searchProfiles 搜索推特个人资料 query:字符串, count?:编号
getFollowers 获取关注推特用户的用户列表 username:字符串, count?:编号
getFollowing 获取Twitter用户关注的用户列表 username:字符串, count?:编号
followUser 关注推特用户 username:字符串

用法

本地运行

# Start the server with environment variables
TWITTER_USERNAME=your_username TWITTER_PASSWORD=your_password TWITTER_EMAIL=your_email@example.com npm start

添加到光标

要将此MCP服务器添加到游标,请执行以下操作:

  1. 在光标中,转到设置>MCP服务器
  2. 点击“添加服务器”
  3. 使用以下设置配置服务器:
    • 名字: Twitter Client MCP (或您喜欢的任何名称)
    • 类型: command
    • 命令: node
    • 参数: /path/to/twitter-client-mcp/dist/index.js (替换为您的实际路径)
    • 环境变量:
      • TWITTER_USERNAME:您的推特用户名
      • TWITTER_PASSWORD:您的推特密码
      • TWITTER_EMAIL:您的推特电子邮件
      • 您要设置的任何其他变量
  4. 点击“保存”

使用NPX(推荐)

您还可以使用npx直接从GitHub运行MCP服务器:

TWITTER_USERNAME=your_username TWITTER_PASSWORD=your_password TWITTER_EMAIL=your_email@example.com npx -y github:mzkrasner/twitter-client-mcp

在游标配置中使用环境变量

为了提高安全性和易用性,请通过配置Cursor .cursor/mcp.json 主目录中的文件:

{
  "mcpServers": {
    "twitter-client-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:mzkrasner/twitter-client-mcp"
      ],
      "env": {
        "TWITTER_USERNAME": "your_username",
        "TWITTER_PASSWORD": "your_password",
        "TWITTER_EMAIL": "your_email@example.com"
      }
    }
  }
}

发展

发展重要提示

在开发MCP服务器时,请使用 console.error() 而不是 console.log() 用于所有调试和日志记录语句。MCP协议通过stdout与客户端通信,因此任何 console.log() 声明会干扰这种沟通。

许可证

麻省理工学院