Social Media MCP Server

社交媒体 MCP 服务

一个模型上下文协议（MCP）服务，可连接多个社交媒体平台，让用户通过自然语言指令跨平台创建和发布内容。

功能

• 自然语言界面：通过简单指令为多个平台创建帖子
• 研究能力：自动研究话题标签、趋势、事实和新闻
• 多平台支持：以各平台专属格式向 Twitter/X、Mastodon 和 LinkedIn 发布内容
• 内容生成：使用多个 AI 模型生成吸引人的内容
• 速率限制管理：通过排队和回退机制妥善处理 API 速率限制
• 分析：跟踪帖子表现并优化内容策略

快速开始

前提条件

• Node.js（v18+）
• npm 或 yarn
• 以下平台的 API 密钥：
  • Twitter/X
  • Mastodon
  • LinkedIn
  • OpenAI 和/或 Anthropic（用于内容生成）
  • Brave Search（用于研究）

安装

1. 克隆代码仓库：

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

2. 安装依赖项：

npm install

3. 创建 .env 文件并填入 API 密钥：

# Twitter API Credentials
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_BEARER_TOKEN=your_bearer_token
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
TWITTER_OAUTH_CLIENT=your_oauth_client
TWITTER_CLIENT_SECRET=your_client_secret

# Mastodon API Credentials
MASTODON_CLIENT_SECRET=your_client_secret
MASTODON_CLIENT_KEY=your_client_key
MASTODON_ACCESS_TOKEN=your_access_token

# LinkedIn API Credentials
LINKEDIN_CLIENT_ID=your_client_id
LINKEDIN_CLIENT_SECRET=your_client_secret
LINKEDIN_ACCESS_TOKEN=your_access_token

# AI API Keys
ANTHROPIC_API_KEY=your_anthropic_key
OPENAI_API_KEY=your_openai_key
BRAVE_API_KEY=your_brave_key

# Application Settings
LOG_LEVEL=info
CACHE_ENABLED=true
RATE_LIMIT_ENABLED=true

4. 构建项目：

npm run build

5. 启动服务：

npm start

MCP 集成

要将此 MCP 服务与 Claude 或其他兼容 MCP 的助手搭配使用，请将其添加到 MCP 设置中：

{
  "mcpServers": {
    "social-media-mcp": {
      "command": "node",
      "args": ["path/to/social-media-mcp/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "your_api_key",
        "TWITTER_API_SECRET": "your_api_secret",
        "TWITTER_BEARER_TOKEN": "your_bearer_token",
        "TWITTER_ACCESS_TOKEN": "your_access_token",
        "TWITTER_ACCESS_SECRET": "your_access_secret",
        "TWITTER_OAUTH_CLIENT": "your_oauth_client",
        "TWITTER_CLIENT_SECRET": "your_client_secret",
        "MASTODON_CLIENT_SECRET": "your_client_secret",
        "MASTODON_CLIENT_KEY": "your_client_key",
        "MASTODON_ACCESS_TOKEN": "your_access_token",
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret",
        "LINKEDIN_ACCESS_TOKEN": "your_access_token",
        "ANTHROPIC_API_KEY": "your_anthropic_key",
        "OPENAI_API_KEY": "your_openai_key",
        "BRAVE_API_KEY": "your_brave_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

create_post

根据自然语言指令，在社交媒体平台上创建并发布内容。

{
  "instruction": "Post about the latest AI developments in healthcare",
  "platforms": ["twitter", "mastodon", "linkedin"],
  "postImmediately": false
}

get_trending_topics

获取社交媒体平台上的热门话题。

{
  "platform": "twitter",
  "category": "technology",
  "count": 5
}

research_topic

使用 Brave Search 和 Perplexity 研究某个话题。

{
  "topic": "artificial intelligence ethics",
  "includeHashtags": true,
  "includeFacts": true,
  "includeTrends": true,
  "includeNews": true
}

开发

项目结构

social-media-mcp/
├── src/
│   ├── index.ts                 # Entry point
│   ├── config/                  # Configuration
│   ├── types/                   # TypeScript type definitions
│   ├── core/                    # Core orchestration logic
│   ├── nlp/                     # Natural language processing
│   ├── research/                # Research engine
│   │   ├── brave/               # Brave Search integration
│   │   ├── perplexity/          # Perplexity integration
│   │   └── aggregator/          # Research result aggregation
│   ├── content/                 # Content generation
│   │   ├── strategies/          # AI model strategies
│   │   ├── formatter/           # Platform-specific formatting
│   │   └── templates/           # Content templates
│   ├── platforms/               # Social media platform integrations
│   │   ├── twitter/             # Twitter API integration
│   │   └── mastodon/            # Mastodon API integration
│   ├── analytics/               # Analytics engine
│   ├── rate-limit/              # Rate limit management
│   └── utils/                   # Utility functions
├── memory-bank/                 # Project documentation
├── build/                       # Compiled JavaScript
├── .env                         # Environment variables
├── package.json                 # Dependencies and scripts
└── tsconfig.json                # TypeScript configuration

脚本

• npm run build：构建项目
• npm run dev：以开发模式运行，并启用热重载
• npm start：启动生产环境服务
• npm test：运行测试
• npm run lint：运行代码检查
• npm run format：格式化代码

实用脚本

scripts 目录包含 Social Media MCP Server 的实用脚本：

• scripts/linkedin-oauth.js：处理 LinkedIn 的 OAuth 2.0 流程以获取访问令牌
  • 用法：cd scripts && npm install && npm run linkedin-oauth
  • 更多详情请参阅 scripts/README.md

文档

documentation 目录包含各社交媒体平台集成的详细文档：

• Mastodon 集成
• Twitter 集成
• LinkedIn 集成
• 集成摘要

许可证

本项目采用 ISC 许可证。

致谢

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