🐦✨ MCP Twitter Post System

by siddreddy07

141 downloads
Not rated
GitHub

Description

# 🐦✨ 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…

About

# 🐦✨ 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…

Details

Author
siddreddy07
Downloads
141
Categories
Other

- Real‑time tweet posting from the command line
- Client‑server communication using Server‑Sent Events (SSE)
- Twitter API integration via the mcptools.js module
- Clean separation of client and server code
- API keys stored securely in a .env file
- Hot‑reloading support with nodemon during development

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name 🐦✨ MCP Twitter Post System
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with npm install in both client/ and server/, then create a .env file in the server/ folder with your Twitter API keys. Start the server with npx nodemon index.js from the server/ directory, then run the client with node index.js from the client/ directory. Tweets are sent from the command line.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83d\udc26\u2728 mcp twitter post system": {
            "mcp-server-twitter-post": {
                "command": "npx",
                "args": [
                    "nodemon",
                    "index.js"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-twitter-post": {
        "command": "npx",
        "args": [
            "nodemon",
            "index.js"
        ]
    }
}

🐦✨ 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 .env file.

---

🌟 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

1. 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! πŸš€
2. Server (server/index.js): The MCP Server catches client commands and directs the tweet-posting action.
3. Tools (server/mcptools.js): Works the Twitter API magic to craft and post tweets with style.
4. Security: API keys stay locked in the .env vault, 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 nodemon for 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! πŸŽ‰

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.