JinDaGe - mcp-server MCP Details

article

README

🚀 SocialAPIs MCP Server

SocialAPIs MCP Server 提供了统一的社交媒体 API，专为 AI 代理设计，能让 AI 便捷地获取多个平台的丰富数据，解决了多平台数据获取的复杂性问题，为 AI 应用提供了高效的支持。

🚀 快速开始

安装

npm install -g @socialapis/mcp

配置

添加到你的 Claude Desktop 配置中：

macOS：

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 配置

方法一：命令行参数（推荐用于 Claude Desktop）

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"]
    }
  }
}

方法二：环境变量

# 设置环境变量
export SOCIALAPIS_API_KEY=your_api_key_here

# 无参数运行
npx @socialapis/mcp

方法三：.env 文件（用于开发）

# 复制示例文件
cp .env.example .env

# 用你的值编辑
nano .env

.env 文件：

SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io

环境变量

| 属性 | 详情 | |------|------| | SOCIALAPIS_API_KEY | 你的 SocialAPIs API 密钥，必需 | | MCP_PROXY_URL | MCP 代理服务器 URL，默认为 https://mcp.socialapis.io | | PORT | HTTP 服务器端口，默认为 3001 | | API_BASE_URL | 后端 API URL，默认为 https://api.socialapis.io/v1 |

获取 API 密钥

在 socialapis.io 上注册。
前往仪表盘。
复制你的 API 密钥。
在配置中替换 YOUR_API_KEY。

测试

重启 Claude Desktop 并询问：

Get Nike's Facebook page details

✨ 主要特性

🌐 统一 API - 一个接口支持多个平台。
🤖 以 AI 为先 - 专为 Claude、Cursor 和 AI 代理构建。
📊 丰富数据 - 提供帖子、评论和参与度指标等。
🔍 高级过滤 - 支持时间范围和分页。
🎯 简单认证 - 无需复杂的 OAuth。
⚡ 快速响应 - 全球边缘网络。
🔒 安全可靠 - API 密钥保持本地。

🛠️ 可用工具

Facebook 页面

facebook_get_page_id - 从 URL 中提取页面 ID。
facebook_get_page_details - 获取页面信息、关注者和点赞数。
facebook_get_page_posts - 按时间过滤获取帖子。
facebook_get_page_reels - 获取卷轴/短视频。

Facebook 群组

facebook_get_group_id - 从 URL 中提取群组 ID。
facebook_get_group_details - 获取群组元数据。
facebook_get_group_posts - 获取群组帖子。

Facebook 帖子

facebook_get_post_id - 从 URL 中提取帖子 ID。
facebook_get_post_details - 获取反应、评论和分享数。
facebook_get_post_attachments - 获取媒体附件。
facebook_get_video_details - 获取视频元数据。
facebook_get_post_comments - 分页获取评论。

更多平台即将推出：Instagram、TikTok、YouTube、Twitter

💻 使用示例

基础用法

Monitor Nike's Facebook page and alert me if engagement drops below average

高级用法

# 品牌监测：监控耐克的 Facebook 页面，如果参与度低于平均水平则提醒
Monitor Nike's Facebook page and alert me if engagement drops below average

# 竞争分析：比较耐克、阿迪达斯和彪马上个月的参与率
Compare engagement rates between Nike, Adidas, and Puma over the last month

# 内容策略：可口可乐的 Facebook 页面上哪种类型的帖子获得的参与度最高？
What types of posts get the most engagement on Coca-Cola's Facebook page?

# 情感分析：分析我们近期帖子的评论并找出常见主题
Analyze comments on our recent posts and identify common themes

🏗️ 架构

Claude Desktop
    ↓
@socialapis/mcp (本地 MCP 客户端)
    ↓
https://mcp.socialapis.io (全球代理)
    ↓
https://api.socialapis.io (数据 API)

为什么采用这种架构？

✅ 低延迟（全球边缘网络）
✅ 高可靠性（99.9% 正常运行时间）
✅ 自动速率限制
✅ 智能缓存
✅ 你的 API 密钥保持本地

🔧 开发

本地设置

# 克隆仓库
git clone https://github.com/SocialAPIsHub/mcp-server.git
cd mcp-server

# 安装依赖
npm install

# 运行 MCP 客户端
npm start YOUR_API_KEY

# 运行 HTTP 代理服务器
npm run serve

项目结构

mcp-server/
├── src/
│   └── tools.js          # 工具定义
├── mcp-wrapper.js        # MCP 客户端（本地运行）
├── server.js             # HTTP 代理服务器
├── package.json
├── Dockerfile
└── README.md

测试

# 本地测试 MCP 客户端
node mcp-wrapper.js YOUR_API_KEY

# 测试 HTTP 代理
curl http://localhost:3001/health
curl http://localhost:3001/tools

# 测试特定工具
curl -X POST http://localhost:3001/proxy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'

📊 定价

| 套餐 | 每月请求量 | 价格 | |------|----------------|-------| | 免费 | 200 | $0 | | 入门版 | 30,000 | $49 | | 专业版 | 120,000 | $179 | | 企业版 | 无限制 | 定制 |

查看详细定价 →

🤝 贡献

我们欢迎贡献！详情请参阅 CONTRIBUTING.md。

快速贡献指南

分叉仓库。
创建功能分支 (git checkout -b feature/amazing-feature)。
提交更改 (git commit -m 'Add amazing feature')。
推送到分支 (git push origin feature/amazing-feature)。
打开拉取请求。

📖 详细文档

💬 支持

📧 邮箱：support@socialapis.io
💬 Discord：discord.gg/socialapis
🐛 问题反馈：GitHub Issues
📚 文档：docs.socialapis.io

🗺️ 路线图

[x] 支持 Facebook API
[x] 实现 MCP 服务器
[x] 实现 HTTP 代理服务器
[x] 发布 npm 包
[ ] 支持 Instagram
[ ] 支持 TikTok
[ ] 支持 YouTube
[ ] 支持 Twitter/X
[ ] 实时 Webhook
[ ] 高级分析
[ ] Python SDK
[ ] LangChain 集成

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

基于 Model Context Protocol 构建。
由 Anthropic Claude 提供支持。
受 AI 代理社区启发。

🌟 星标历史

由 SocialAPIs 团队用心打造

网站 • Twitter • Discord

mcp-server