Twitter Client MCP

一个模型上下文协议 (MCP) 服务器，通过 agent-twitter-client 库提供对 Twitter 功能的安全访问。

功能特性

Twitter Client MCP 提供以下功能：

• 个人资料操作

  • 通过用户名获取个人资料信息
  • 获取已验证用户的个人资料

• 推文操作

  • 通过 ID 获取特定推文
  • 获取用户的推文
  • 发送新推文
  • 喜欢推文
  • 转发推文

• 搜索操作

  • 搜索推文
  • 搜索个人资料

• 关系操作

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

安全 ⚠️

重要提示：Twitter 凭据保护

此 MCP 服务器需要 Twitter 凭据才能运行。 为了保护这些敏感凭据：

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

多层保护

此服务器实现了多层安全保护，以确保您的凭据安全：

1. 凭据隔离

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

2. 内存保护

• 使用 sodium-native 进行安全内存分配
• 内存锁定以防止交换到磁盘
• 使用后清零内存缓冲区

3. 访问预防

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

设置

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

必需的环境变量

Twitter Client MCP 需要以下环境变量：

TWITTER_USERNAME=您的用户名
TWITTER_PASSWORD=您的密码
TWITTER_EMAIL=您的邮箱@example.com

（可选）您可以添加 Twitter API v2 凭据以获得高级功能：

TWITTER_API_KEY=您的 API 密钥
TWITTER_API_SECRET_KEY=您的 API 密钥密钥
TWITTER_ACCESS_TOKEN=您的访问令牌
TWITTER_ACCESS_TOKEN_SECRET=您的访问令牌密钥

工具

该服务器公开以下 MCP 工具：

工具名称	描述	参数
profileByUsername	通过用户名获取 Twitter 个人资料	username: 字符串
myProfile	获取已验证用户的个人资料	check: 布尔值
getTweet	通过 ID 获取特定推文	tweetId: 字符串
getUserTweets	获取 Twitter 用户的推文	username: 字符串, count?: 数字
sendTweet	发布新推文	text: 字符串, inReplyToId?: 字符串
likeTweet	喜欢一条推文	tweetId: 字符串
retweet	转发一条推文	tweetId: 字符串
searchTweets	搜索推文	query: 字符串, count?: 数字, searchMode?: 字符串 ('top', 'latest', 'photos', 'videos')
searchProfiles	搜索 Twitter 个人资料	query: 字符串, count?: 数字
getFollowers	获取关注 Twitter 用户的用户列表	username: 字符串, count?: 数字
getFollowing	获取 Twitter 用户正在关注的用户列表	username: 字符串, count?: 数字
followUser	关注 Twitter 用户	username: 字符串

用法

在本地运行

# 使用环境变量启动服务器
TWITTER_USERNAME=您的用户名 TWITTER_PASSWORD=您的密码 TWITTER_EMAIL=您的邮箱@example.com npm start

添加到 Cursor

要将此 MCP 服务器添加到 Cursor：

1. 在 Cursor 中，转到 Settings > MCP Servers
2. 单击“Add Server”
3. 使用以下设置配置服务器：
   • Name: Twitter Client MCP（或您喜欢的任何名称）
   • Type: command
   • Command: node
   • Arguments: /path/to/twitter-client-mcp/dist/index.js（替换为您的实际路径）
   • Environment Variables:
     • TWITTER_USERNAME: 您的 Twitter 用户名
     • TWITTER_PASSWORD: 您的 Twitter 密码
     • TWITTER_EMAIL: 您的 Twitter 电子邮件
     • 您要设置的任何其他变量
4. 单击“Save”

使用 NPX（推荐）

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

TWITTER_USERNAME=您的用户名 TWITTER_PASSWORD=您的密码 TWITTER_EMAIL=您的邮箱@example.com npx -y github:mzkrasner/twitter-client-mcp

在 Cursor 配置中使用环境变量

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

{
  "mcpServers": {
    "twitter-client-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:mzkrasner/twitter-client-mcp"
      ],
      "env": {
        "TWITTER_USERNAME": "您的用户名",
        "TWITTER_PASSWORD": "您的密码",
        "TWITTER_EMAIL": "您的邮箱@example.com"
      }
    }
  }
}

开发

开发的重要提示

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

许可证

MIT