使用说明
社交媒体MCP服务器
一种模型上下文协议(MCP)服务器,连接到多个社交媒体平台,允许用户通过自然语言指令跨平台创建和发布内容。
特性
- 自然语言接口:使用简单的说明为多个平台创建帖子
- 研究能力:自动研究标签、趋势、事实和新闻
- 多平台支持:发布到推特/X、Mastodon和领英,采用特定平台的格式
- 内容生成:使用多种AI模型生成引人入胜的内容
- 费率限制管理:通过排队和回退优雅地处理API速率限制
- 分析:跟踪帖子性能并优化内容策略
入门指南
先决条件
- Node.js(v18+)
- npm或纱线
- API密钥用于:
- 推特/X
- 乳齿象
- 领英
- OpenAI和/或Anthropic(用于内容生成)
- 勇敢的搜索(用于研究)
安装
- 克隆存储库:
git clone https://github.com/yourusername/social-media-mcp.git
cd social-media-mcp
- 安装依赖项:
npm install
- 创建一个
.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
- 构建项目:
npm run build
- 启动服务器:
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
}
获取_渲染_主题
从社交媒体平台获取热门话题。
{
"platform": "twitter",
"category": "technology",
"count": 5
}
研究主题
使用勇敢搜索和困惑来研究一个主题。
{
"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:运行lintingnpm run format:格式代码
实用程序脚本
这 scripts 目录包含社交媒体MCP服务器的实用程序脚本:
scripts/linkedin-oauth.js:处理用于LinkedIn获取访问令牌的OAuth 2.0流- 用途:
cd scripts && npm install && npm run linkedin-oauth - 看 scripts/README.md 详情请见
- 用途:
文档
这 documentation 目录包含每个社交媒体平台集成的详细文档:
许可证
该项目根据ISC许可证获得许可。