MCP Server is a powerful, lightweight server designed to automate tweeting on your behalf. Whether you want to schedule tweets, post updates programmatically, or integrate tweeting into your apps, MCP Server has you covered.
π See It in Action! π₯ Live Demo: Want to see TweetPilot MCP in action? π Watch the Demo Video on X π₯
- π¦ Automated Tweet Posting: Schedule and send tweets effortlessly
- π Secure OAuth Authentication: Safely connect your Twitter account
- βοΈ RESTful API: Easily integrate tweeting capabilities into any app
- π Custom Scheduling: Post tweets at specific times or intervals
- π Tweet Status Tracking: Monitor success or failure of tweets
- π Retry Mechanism: Automatic retries for failed tweet attempts
Component | Technology |
---|---|
Server | Node.js, Express.js |
Twitter API | Twitter API v2, OAuth 2.0 |
Scheduling | node-cron |
Database (Opt.) | MongoDB (for tweet logs) |
- Node.js (v14+)
- Twitter Developer Account with API keys & tokens
- (Optional) MongoDB for logging
- Clone the repo
git clone https://github.com/yourusername/mcp-server.git
cd mcp-server
- Install dependencies
npm install
- Configure environment variables
Create a .env
file with the following variables:
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
PORT=3000
- Start the server
npm start
Method | Endpoint | Description |
---|---|---|
POST | /tweet |
Post a new tweet immediately |
POST | /schedule |
Schedule a tweet for later |
GET | /status/:id |
Get status of a tweet by ID |
curl -X POST http://localhost:3000/tweet \
-H "Content-Type: application/json" \
-d '{"message": "Hello world from MCP Server!"}'
Contributions are welcome! To contribute:
- Fork the repo
- Create your feature branch (
git checkout -b feature/YourFeature
) - Commit your changes (
git commit -m 'Add feature'
) - Push to your branch (
git push origin feature/YourFeature
) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.