AI导哈

Twitter自动化代理

Twitter MCP Agent是一个开源MCP服务器，允许任何LLM自动化操作Twitter/X账户，包括发推、定时发推、自动回复等功能。

  • by Gaurav775-Git
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Gaurav775-Git/X-agent-MCP-server

使用说明

🐦 Twitter MCP代理

一个开源的MCP服务器，使用任何LLM自动化Twitter/X

📖 什么是Twitter MCP代理？

Twitter MCP代理 是一个完全开源的 模型上下文协议（MCP） 服务器允许 任何LLM都会自动创建您的Twitter/X帐户。只需描述你想在推特上发布什么，LLM就会处理其余的事情。

You (prompt your LLM)
       ↓
    LLM
       ↓ calls a tool
  [post_tweet tool]
       ↓
  Your MCP Server  (Node.js)
       ↓
  Twitter/X API
       ↓
  Tweet goes live ✅

内置于 Node.js（ES模块） 以及官方的MCP SDK——轻量级、可扩展且易于贡献。

✨ 特性

  • ✅ 直接通过LLM发布推文
  • 🕐 安排推文以供将来发布
  • 💬 自动回复提及和帖子
  • 🔍 搜索并转发相关内容
  • 🔌 建立在官方 @modelcontextprotocol/sdk
  • 🧩 简单的ES模块架构——易于阅读和扩展

🛠️ 技术栈

包装 用途
@modelcontextprotocol/sdk MCP协议处理程序
twitter-api-v2 Twitter/X API v2客户端
zod 工具输入验证
dotenv 环境变量管理

🚀 入门指南

先决条件

1.克隆存储库

git clone https://github.com/your-username/twitter-mcp.git
cd twitter-mcp

2.安装依赖项

npm install

3.配置环境

创建一个 .env 根目录中的文件：

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret

⚠️ 永远不要承诺你的 .env 文件。它已经在里面了 .gitignore.

4.运行服务器

npm start

📁 项目结构

twitter-mcp/
├── src/
│   ├── index.js          ← MCP server entry point
│   ├── twitter.js        ← Twitter API client setup
│   └── tools/
│       └── postTweet.js  ← Tool definition + handler
├── .env                  ← Your API keys (never commit)
├── .gitignore
└── package.json

🤝 贡献

这个项目是 开源 我们热烈欢迎您的贡献——无论是修复错误、添加功能、改进文档，还是只是分享想法。每一份贡献都让这一切变得更好！

如何做出贡献

  1. 分叉 存储库
  2. 创建分支 为您的功能
    git checkout -b feature/your-feature-name
  3. 进行更改 并承诺
    git commit -m "feat: add your feature"
  4. 推 到你的叉子
    git push origin feature/your-feature-name
  5. 打开A 拉取请求 并描述您的更改

💡 贡献的想法

  • []添加 schedule_tweet 工具
  • []添加 delete_tweet 工具
  • []添加 fetch_analytics 工具
  • []改进错误处理和重试逻辑
  • []添加推特限速意识
  • []为现有工具编写单元测试
  • []添加对推特帖子（多条推特帖子）的支持
  • []改进文档和使用示例

欢迎所有技能水平。如果你是开源新手，这是一个很好的起点！ 🌱

📄 许可证

该项目根据 MIT许可证 --您可以自由使用、修改和分发它。 看 许可证 文件以获取详细信息。

🌟 支持

如果这个项目对你有帮助，请考虑给它一个 ⭐ 星 在GitHub上——它帮助其他人发现它！

Made with ❤️ by the community

相关 MCP