🐦✨ MCP Twitter Post System
🐦✨ MCP Twitter Post System
Welcome to the MCP Twitter Post System — your go-to tool for launching tweets into the Twitterverse with real-time flair! 🚀 Powered by Node.js, Server-Sent Events (SSE), and the Twitter API, this project is neatly split into client/ and server/ folders for a smooth, organized workflow. Get ready to tweet like a rockstar! 🌟
📂 Project Structure
Here's the blueprint of the MCP Twitter Post System:
| Path | Description |
|---|---|
client/ | 🌐 The MCP Client, your tweet-launching control hub |
client/index.js | 🚀 Fires off real-time tweet commands to the server |
server/ | 🛠️ The MCP Server, the genius behind the scenes |
server/index.js | 🖥️ Runs the HTTP server and SSE wizardry |
server/mcptools.js | 🐦 Crafts tweets with Twitter API magic |
.env | 🔒 Safely stores your Twitter API keys |
README.md | 📖 You're soaking in this epic guide right now! |
🎉 Features That Make Tweeting a Blast
- ⚡ Real-Time Tweet Action: Send tweets straight from your command line in a flash!
- 📡 Seamless SSE Connection: Client and server vibe together with Server-Sent Events.
- 🐦 Twitter API Power: Post tweets securely using the Twitter API.
- 🧩 Clean Separation: Client and server logic are organized like a pro.
- 🔐 Safe Secrets: API keys stay secure in a
.envfile.
🌟 Spotlight: The MCP Server
The MCP Server is the heart and soul of this project! 🛠️💥 Housed in the server/ folder, it’s the powerhouse that listens for your tweet commands, orchestrates real-time communication via SSE, and seamlessly integrates with the Twitter API to make your tweets soar. Running on index.js and powered by mcptools.js, the MCP Server ensures every tweet is crafted with precision and posted securely. It’s like having a tweet-slinging superhero at your command! 🦸♂️
🛠️ Setup: Let’s Launch Your Tweet Machine!
1. Clone the Repo
Dive into the Twitterverse by grabbing the code:
git clone https://github.com/siddreddy07/mcp-server-twitter-post.git
cd mcp-twitter-post
2. Install Dependencies (If Needed)
Hop into both client/ and server/ folders and run:
npm install
No
package.json? Skip this step and keep the tweet party rolling! 🎉
3. Configure Your Twitter API Keys
Create a .env file in the server/ folder and add your Twitter API credentials:
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
✨ Pro Tip: Snag these keys from the Twitter Developer Portal!
🚀 Running the Project
Start the MCP Server
Launch the MCP Server to handle your tweet requests:
cd server
npx nodemon index.js
Fire Up the MCP Client
Kick off the client to send tweets in real-time:
cd client
node index.js
Watch your CLI sparkle as your tweets take flight! 🐦✨
🧠 How It All Works
- Client (
client/index.js): Your command center sends tweet data via HTTP or SSE. Type, hit enter, and BOOM — it’s off to the server! 🚀 - Server (
server/index.js): The MCP Server catches client commands and directs the tweet-posting action. - Tools (
server/mcptools.js): Works the Twitter API magic to craft and post tweets with style. - Security: API keys stay locked in the
.envvault, safe from prying eyes. 🔒
⚙️ Tech Stack That Rocks
- Node.js: The engine driving this tweet-tastic journey.
- Express (or native HTTP): Powers the MCP Server with slick efficiency.
- Server-Sent Events (SSE): Keeps client-server communication lightning-fast.
- Twitter API: Via
twitter-api-v2(or your favorite Twitter package). - Dotenv: Keeps your API keys cozy and secure. 😎
📝 Quick Tips for Tweet Domination
- 🛡️ Ensure your Twitter Developer account is active and your app is approved.
- 🔥 Use
nodemonfor hot-reloading to keep the MCP Server development smooth. - 💡 Check the CLI for real-time tweet feedback.
- 🌐 Explore the Twitter API Docs for advanced tweaks.
🐛 Bugs or Brilliant Ideas?
We’re all about making this project shine! 🌟 Open an issue, submit a pull request, or tweet us your thoughts (manually for now 😉) to join the fun.
Happy Tweeting! 🎉