twitter-client-mcp

🚀 Twitter 客户端 MCP 服务器

Twitter 客户端 MCP 服务器借助 agent-twitter-client 库，提供对 Twitter 功能的安全访问，有效解决了安全调用 Twitter 功能的问题，为用户提供便捷、安全的使用体验。

🚀 快速开始

若你想使用 Twitter 客户端 MCP 服务器，可按以下步骤操作：

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

3. 启动服务器：

   node index.js
   

✨ 主要特性

Twitter 客户端 MCP 具备丰富的功能，涵盖个人资料操作、微博操作、搜索功能和关系操作等多个方面：

• 个人资料操作
  • 通过用户名获取个人资料信息。
  • 获取已认证用户的个人资料。
• 微博操作
  • 通过 ID 获取特定微博。
  • 获取用户发布的微博。
  • 发送新的微博。
  • 赞同微博。
  • 转发微博。
• 搜索功能
  • 搜索微博。
  • 搜索个人资料。
• 关系操作
  • 获取某个用户的关注者列表。
  • 获取某个用户正在关注的用户列表。
  • 关注某个用户。

⚠️ 安全注意事项

⚠️ 重要提示

此 MCP 服务器需要 Twitter 凭证才能运行。为了保护这些敏感凭证，你需要做到：

1. 绝不能分享你的凭证。
2. 绝不能执行会显示凭证的命令。
3. 绝不能让 LLM 在未经批准的情况下直接执行 shell 命令。

多层安全保护

此服务器实现了几种安全措施来保护你的凭证：

1. 凭证隔离

• 你的凭证仅在初始化时加载。
• 加载后，凭证立即从环境变量中移除。
• 凭证从未被记录或传输到 LLM。

2. 内存保护

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

3. 访问控制

• 安全的环境变量处理。
• 对所需环境变量进行严格的验证。
• 控制台输出 sanitize 以防止凭证泄露。

📦 安装指南

环境变量要求

在使用服务器前，你需要设置以下环境变量： | 属性 | 详情 | |------|------| | TWITTER_API_KEY | Twitter API 的密钥 | | TWITTER_API_SECRET_KEY | Twitter API 的秘密密钥 | | TWITTER_ACCESS_TOKEN | 访问令牌 | | TWITTER_ACCESS_TOKEN_SECRET | 访问令牌的秘密 |

📚 详细文档

工具列表

以下工具可供使用： | 命令 | 描述 | | ---- | ---- | | getProfileByUsername | 通过用户名获取个人资料信息 | | getTweetsByUser | 获取某个用户的微博 | | sendTweet | 发送新的微博 | | likeTweet | 赞同某条微博 | | retweet | 转发某条微博 |

🔧 技术细节

开发提示

💡 使用建议

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

📄 许可证

本项目采用 MIT 许可证。