关于 🐦✨ MCP Twitter Post System
这是一个通过 Twitter API 发帖的 MCP 服务和 Node.js 客户端。客户端与发帖逻辑分开,并使用 SSE 进行通信。
主要功能
- 01通过 Twitter API 发布推文
- 02使用 SSE 连接客户端与服务端
- 03从命令行发送推文指令
- 04将 API 凭据存入 `.env`
适用场景
- 01在命令行工作流中发布推文
- 02向独立服务端发送发帖请求
- 03将 Twitter API 凭据保存在环境文件中
MCP 相关
MCP 服务接收推文指令并调用 Twitter API 发帖;附带的客户端通过 HTTP 或 SSE 与其通信。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
🐦✨ MCP Twitter 发帖系统
欢迎使用 MCP Twitter 发帖系统——这是你在 Twitter 世界中实时发布精彩推文的得力工具!🚀 本项目由 Node.js、Server-Sent Events (SSE) 和 Twitter API 驱动,并清晰地划分为 client/ 和 server/ 文件夹,让工作流顺畅有序。准备好像摇滚巨星一样发推吧!🌟
📂 项目结构
以下是 MCP Twitter 发帖系统的蓝图:
| 路径 | 说明 |
|---|---|
client/ | 🌐 MCP 客户端,你的推文发布控制中心 |
client/index.js | 🚀 向服务发送实时推文命令 |
server/ | 🛠️ MCP 服务,幕后的核心 |
server/index.js | 🖥️ 运行 HTTP 服务并处理 SSE |
server/mcptools.js | 🐦 借助 Twitter API 的强大功能编写推文 |
.env | 🔒 安全存储你的 Twitter API 密钥 |
README.md | 📖 你现在正在阅读这份精彩指南! |
🎉 让发推充满乐趣的功能
- ⚡ 实时发推:从命令行直接快速发送推文!
- 📡 无缝 SSE 连接:客户端和服务端通过 Server-Sent Events 实现顺畅协作。
- 🐦 Twitter API 的强大功能:使用 Twitter API 安全发布推文。
- 🧩 清晰分离:客户端和服务端逻辑井然有序。
- 🔐 安全保密:API 密钥安全地存放在
.env文件中。
🌟 聚焦:MCP 服务
MCP 服务是本项目的核心所在!🛠️💥 它位于 server/ 文件夹中,是一台强大的引擎,负责监听你的推文命令,通过 SSE 协调实时通信,并无缝集成 Twitter API,让你的推文一飞冲天。MCP 服务通过 index.js 运行,并由 mcptools.js 提供支持,确保每条推文都经过精心编写并安全发布。它就像一位随时听候差遣、挥洒推文的超级英雄!🦸♂️
🛠️ 设置:启动你的推文机器!
1. 克隆仓库
获取代码,进入 Twitter 世界:
git clone https://github.com/siddreddy07/mcp-server-twitter-post.git
cd mcp-twitter-post
2. 安装依赖(如有需要)
进入 client/ 和 server/ 文件夹,并运行:
npm install
没有
package.json?跳过这一步,继续享受发推的乐趣吧!🎉
3. 配置你的 Twitter API 密钥
在 server/ 文件夹中创建 .env 文件,并添加你的 Twitter API 凭据:
API_KEY=your_twitter_app_key
API_SECRET_KEY=your_twitter_app_secret
ACCESS_TOKEN=your_twitter_access_token
ACCESS_SECRET_TOKEN=your_twitter_access_secret
✨ 实用提示:在 Twitter Developer Portal 获取这些密钥!
🚀 运行项目
启动 MCP 服务
启动 MCP 服务来处理你的推文请求:
cd server
npx nodemon index.js
启动 MCP 客户端
启动客户端,实时发送推文:
cd client
node index.js
看着你的 CLI 闪闪发光,推文也随之展翅飞翔!🐦✨
🧠 工作原理
- 客户端(
client/index.js):你的指挥中心通过 HTTP 或 SSE 发送推文数据。输入内容,按下回车,砰——推文就发往服务端了!🚀 - 服务端(
server/index.js):MCP 服务接收客户端命令,并调度推文发布操作。 - 工具(
server/mcptools.js):施展 Twitter API 的强大功能,巧妙地编写并发布推文。 - 安全性:API 密钥安全地锁在
.env保险库中,远离窥探。🔒
⚙️ 强大的技术栈
- Node.js:驱动这段精彩发推之旅的引擎。
- Express(或原生 HTTP):高效地为 MCP 服务提供支持。
- Server-Sent Events (SSE):让客户端与服务端之间的通信快如闪电。
- Twitter API:通过
twitter-api-v2(或你喜欢的 Twitter 软件包)接入。 - Dotenv:妥善、安全地保管你的 API 密钥。😎
📝 推文制胜的快速技巧
- 🛡️ 确保你的 Twitter 开发者账号处于启用状态,且你的应用已获批准。
- 🔥 使用
nodemon热重载,让 MCP Server 开发更顺畅。 - 💡 查看 CLI,获取实时推文反馈。
- 🌐 浏览 Twitter API 文档,了解高级调整方法。
🐛 发现问题或有妙点子?
我们致力于让这个项目大放异彩!🌟 提交 issue、发起 pull request,或在 Twitter 上告诉我们你的想法(目前需要手动操作 😉),一起加入其中吧。
祝你发推愉快! 🎉
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。