social-media-mcp-server

dannwaneri/social-media-mcp-server

3.2

If you are the rightful owner of social-media-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

AI-powered social media automation using the Model Context Protocol (MCP), designed for Cloudflare Workers with edge-native architecture.

Tools
4
Resources
0
Prompts
0

Social Media MCP Server

AI-powered social media automation using the Model Context Protocol (MCP). Built for Cloudflare Workers with edge-native architecture.

Features

  • 🤖 AI Content Generation - Groq Llama 3.3 70B (FREE tier)
  • 📱 Multi-Platform Posting - Twitter, LinkedIn, Facebook, Instagram via Ayrshare
  • 💾 SQLite → D1 Ready - Easy migration to Cloudflare D1
  • 🌍 Edge-Native - Built for Cloudflare Workers deployment
  • 📝 8 MCP Tools - draft_post, schedule_post, post_immediately, generate_thread, and more

Quick Start

Prerequisites

Installation

# Clone the repo
git clone https://github.com/YOUR_USERNAME/social-media-mcp-server.git
cd social-media-mcp-server

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Build
npm run build

# Run locally
npm run dev

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "social-media": {
      "command": "node",
      "args": ["/absolute/path/to/social-media-mcp-server/build/index.js"],
      "env": {
        "AYRSHARE_API_KEY": "your-key",
        "GROQ_API_KEY": "your-key"
      }
    }
  }
}

Architecture

MCP Server
├── Tools (8)
│   ├── draft_post - Create AI-optimized content
│   ├── schedule_post - Schedule for later
│   ├── post_immediately - Post now
│   ├── generate_thread - Twitter threads
│   └── ... 4 more
├── Resources (3)
│   ├── drafts://list
│   ├── scheduled://posts
│   └── stats://summary
└── Prompts (3)
    ├── write_tweet
    ├── linkedin_post
    └── thread_generator

Cost

  • Groq API: $0 (free tier)
  • Ayrshare: $0 (10 posts/month free)
  • Cloudflare Workers: $5/month (includes D1, KV, Vectorize)
  • Total: $5/month

Tools

draft_post

Create AI-generated social media posts optimized for each platform.

// Example usage in Claude Desktop
"Create a professional tweet about edge computing"

post_immediately

Post content to social media platforms immediately.

generate_thread

Generate Twitter threads (2-10 tweets).

Edge Deployment

Ready for Cloudflare Workers deployment. See for details.

Development

# Run in dev mode
npm run dev

# Build
npm run build

# Type check
npm run type-check

Tech Stack

  • TypeScript - Type safety
  • MCP SDK - Model Context Protocol
  • Groq - AI content generation (Llama 3.3 70B)
  • Ayrshare - Multi-platform social media API
  • SQLite/D1 - Storage layer
  • Cloudflare Workers - Edge deployment

Why MCP over LangGraph?

Read the full breakdown: [Article Link]

TL;DR:

  • 800 lines vs 2,000+ lines
  • $5/month vs $50-80/month
  • Edge-compatible vs requires VPS
  • Protocol-based vs framework-specific

License

MIT

Author

Built by Daniel Nwaneri - Full-stack developer from Port Harcourt, Nigeria.

Contributing

Contributions welcome! Please read first.

Roadmap

  • Template library with semantic search
  • Multi-account support
  • Analytics dashboard
  • Webhook integrations
  • Full Cloudflare Workers deployment guide

Acknowledgments