Social Media MCP

🚀 Social Media MCP Server

A Model Context Protocol (MCP) server that connects to multiple social media platforms, allowing users to create and publish content via natural language instructions.

🚀 Quick Start

Prerequisites

• Node.js (version 14.0 or higher recommended)
• npm (version 6.0 or higher recommended)
• Familiarity with command-line operations
• Access to Twitter, Mastodon, and LinkedIn APIs

Installation Steps

1. Clone the repository:

   git clone https://github.com/yourusername/social-media-mcp.git
   cd social-media-mcp
   

2. Install dependencies:

   npm install
   

3. Configure environment variables:

   • Create a .env file and populate it with the following, replacing with actual API keys and secrets:

     TWITTER_API_KEY=your_twitter_api_key
     TWITTER_API_SECRET=your_twitter_api_secret
     MASTODON_INSTANCE_URL=your_mastodon_instance_url
     MASTODON_APP_TOKEN=your_mastodon_app_token
     LINKEDIN_CLIENT_ID=your_linkedin_client_id
     LINKEDIN_CLIENT_SECRET=your_linkedin_client_secret
     

4. Build the project:

   npm run build
   

5. Start the development server:

   npm run dev
   

6. Run the production server:

   npm start
   

✨ Features

• Natural Language Interface: Create posts on multiple platforms using simple instructions.
• Research Capability: Automatically research topics, hashtags, trends, facts, and news.
• Multi-Platform Support: Publish in platform-specific formats to Twitter/X, Mastodon, and LinkedIn.
• Content Generation: Leverage multiple AI models to generate engaging content.
• Rate Limit Management: Gracefully handle API rate limits through queuing and backoff mechanisms.
• Analytics: Track post performance and optimize content strategies.

💻 Usage Examples

Basic Usage

The basic usage of this server is to follow the installation steps and then start using the natural language interface to create and publish content on social media platforms. For example, after starting the server, you can input natural language instructions to create a post on Twitter.

Advanced Usage

You can integrate this server with various AI models according to the MCP integration section, and define more complex content generation strategies to achieve highly customized social media management.

📚 Documentation

MCP Integration

This server follows the Model Context Protocol, allowing integration with various AI models (e.g., Claude). Through clearly defined content generation strategies, highly customized social media management can be achieved.

Available Tools

• Natural Language Processing: Parse user instructions and generate corresponding content.
• Research Engine: Integrate search engines like Brave and Perplexity to obtain the latest information.
• Content Strategy: Flexibly adjust content formats and styles for different platforms.
• Analytics Module: Track post interactions, engagement, and performance metrics.

Development Structure

The project's code structure is as follows:

src/
├── core/                 # Core coordination logic
├── nlp/                 # Natural language processing
├── research/            # Research engine
│   ├── brave/           # Brave search integration
│   └── perplexity/      # Perplexity integration
├── content/             # Content generation
│   ├── strategies/      # AI model strategies
│   └── templates/       # Content templates
├── platforms/           # Social media platform integration
│   ├── twitter/         # Twitter API integration
│   └── mastodon/        # Mastodon API integration
└── analytics/           # Analytics engine

scripts/
├── linkedin-oauth.js    # LinkedIn OAuth tool
└── other-scripts/       # Other auxiliary scripts

documentation/
├── mastodon-integration.md   # Mastodon integration documentation
├── twitter-integration.md    # Twitter integration documentation
└── linkdin-integration.md    # LinkedIn integration documentation

Scripts

• npm run build: Build the project.
• npm run dev: Run in development mode with hot reloading support.
• npm start: Start the production server.
• npm test: Run tests.
• npm run lint: Perform code checks.
• npm run format: Format the code.

Utility Scripts

The scripts/ directory contains some auxiliary tools:

• LinkedIn OAuth Tool:
  • Usage: cd scripts && npm install && npm run linkedin-oauth
  • See scripts/README.md for more details.

Platform Integration Documentation

The documentation/ directory provides detailed platform integration documentation:

• Mastodon Integration
• Twitter Integration
• LinkedIn Integration

📄 License

This project is licensed under the ISC license.

Acknowledgments

• Model Context Protocol
• Twitter API v2
• Mastodon API
• LinkedIn API