社交媒体发布MCP网关

Social Media MCP Gateway

Post to 13+ social networks from your AI coding agent (Cursor, VS Code, etc.) through a single Docker MCP Gateway endpoint.

Architecture

Cursor / AI Agent
       |
       |  Streamable HTTP (localhost:8811/sse)
       v
+-------------------------+
|   Docker MCP Gateway    |
|  Aggregates all servers |
|  Injects secrets per    |
|  container              |
+---+---+---+---+---+---+-+
    |   |   |   |   |   |
    v   v   v   v   v   v
   7 isolated Docker containers

Note: Crosspost overlaps with twitter-enhanced and bluesky-enhanced for basic posting. Crosspost is for quick multi-platform blasts; the enhanced servers add rich read/search/engagement tools. Both can run simultaneously -- the AI picks the right tool based on your prompt.

Prerequisites

• Docker Desktop with MCP Gateway support
• Docker MCP Gateway installed via Homebrew (brew install docker-mcp)

Setup

1. Clone the repo:

   复制

   git clone git@github.com:ryanjafari/social-media-mcp-gateway.git
   cd social-media-mcp-gateway
   

2. Create your .env file:

   复制

   cp .env.example .env
   

3. Fill in credentials for the platforms you want to use. Leave the rest blank -- only servers with credentials will be activated.

4. Run setup:

   复制

   bash setup.sh
   

   This will: build Docker images, register the catalog, store secrets via docker mcp secret set, enable servers, and restart the gateway.

5. Configure your AI agent. In Cursor's mcp.json (or equivalent):

   复制

   {
     "mcpServers": {
       "docker-mcp": {
         "url": "http://localhost:8811/sse"
       }
     }
   }
   

Adding more platforms later

Fill in the new credentials in .env and re-run bash setup.sh. The script only builds and enables servers that have credentials -- everything else is skipped.

Secret naming convention

Secrets are stored in Docker MCP's secret store with a servername. prefix, matching the convention used by built-in servers:

github.personal_access_token          # built-in
notion.internal_integration_token     # built-in
substack.substack_publication_url     # ours
substack.substack_session_token       # ours
reddit.reddit_client_id               # ours

Project structure

.
├── .env.example                 # Credential template (all fields blank)
├── setup.sh                     # One-command setup script
├── social-media-catalog.yaml    # Docker MCP catalog definition
├── Dockerfile                   # Crosspost server image
├── substack-enhanced/           # Custom Substack MCP server (built by us)
│   ├── index.js
│   ├── package.json
│   └── Dockerfile
├── medium/Dockerfile
├── reddit/Dockerfile
├── facebook/Dockerfile
├── twitter-enhanced/Dockerfile
├── bluesky-enhanced/Dockerfile
└── docs/
    └── architecture.html        # Visual architecture diagram (open in browser)

Credential guides