Twitter 客户端 MCP

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

特性

Twitter 客户端 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 客户端 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	根据用户名获取 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=your_username TWITTER_PASSWORD=your_password TWITTER_EMAIL=your_email@example.com npm start

添加到 Cursor

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

1. 在 Cursor 中，转到设置 > MCP 服务器
2. 点击“添加服务器”
3. 使用以下设置配置服务器：
   • 名称：Twitter 客户端 MCP（或您喜欢的任何名称）
   • 类型：command
   • 命令：node
   • 参数：/path/to/twitter-client-mcp/dist/index.js（替换为您实际的路径）
   • 环境变量：
     • TWITTER_USERNAME：您的 Twitter 用户名
     • TWITTER_PASSWORD：您的 Twitter 密码
     • TWITTER_EMAIL：您的 Twitter 邮件地址
     • 您想要设置的其他变量
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 文件配置 Cursor：

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

开发

开发的重要注意事项

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

许可证

MIT