Social Neuron

@socialneuron/mcp-server

91 个公开 MCP 工具，用于 AI 驱动的社交媒体管理。从 Claude Code 或任何 MCP 客户端创建内容、安排帖子、跟踪分析数据并优化效果。

快速开始

1. 进行身份验证

npx -y @socialneuron/mcp-server login --device

这会打开浏览器以授权访问。需要 Social Neuron Pro 或更高级别的套餐。请参阅定价。

2. 添加到 Claude Code

claude mcp add socialneuron -- npx -y @socialneuron/mcp-server

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

{
  "servers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

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

3. 开始使用

询问 Claude：“我这周应该发布什么内容？”或“把我最新的视频安排到 YouTube 和 TikTok 发布。”

你可以做什么

可以向 Claude 提出以下请求：

• “为 Z 世代生成 5 个关于可持续时尚的内容创意”
• “为我的产品发布制作一段 30 秒的广告视频”
• “明天上午 9 点将这篇帖子安排到 X 和 Bluesky 发布”
• “展示我本月表现最好的内容”
• “目前我的细分领域有哪些热门话题？”
• “查看我的分析数据并提出改进建议”
• “设置自动发布，每周发布 3 次”

工具类别

npm 包通过每种传输方式提供 91 个公开工具。单独版本控制的托管服务提供 92 个公开工具，其中包括仅托管服务提供的 get_account_status。托管 HTTP 包含 Content Calendar 和 Analytics Pulse MCP Apps；npm stdio 则提供 2 个本地屏幕捕获工具。当前托管工具数量公布在服务卡片中。npm 包在其声明的引擎范围内支持 Node 20.20+ 和 Node 22.22+。托管服务运行独立的 3.0.0 契约；其版本与经过审核的工具清单一同记录在 server.json.hosted 中。

AI Agent（Claude、Cursor 等）可通过 MCP 协议使用这些工具。

内容生命周期

管理与优化

实用工具

交互式 MCP 应用（托管 HTTP）

应用仅会在支持 MCP Apps 扩展的 MCP 宿主中渲染。所有底层数据和写入操作仍由常规的范围限定工具执行，因此，不具备交互式 UI 的宿主也可以通过文本／工具调用使用相同的工作流。

身份验证

提供三种身份验证方式，按推荐顺序排列：

设备代码（推荐）

npx -y @socialneuron/mcp-server login --device

打开浏览器并完成授权后，CLI 会自动接收 API 密钥。

浏览器流程

npx -y @socialneuron/mcp-server login

基于浏览器的 OAuth 流程。

粘贴 API 密钥

npx -y @socialneuron/mcp-server login --paste

在 socialneuron.com/settings/developer 生成密钥，然后粘贴到此处。

密钥会存储在操作系统的密钥链中（macOS Keychain、Linux secret-tool）；如果操作系统支持，则会以仅所有者可访问的权限创建文件作为备用存储方式。

Windows 用户：文件备用存储方式（~/.config/social-neuron/credentials.json）在 NTFS 上无法强制实施严格的权限控制。在 Windows 上用于生产环境时，请改为设置 SOCIALNEURON_API_KEY 环境变量。

定价

MCP/API 访问需要 Pro 或更高级别的套餐：

请访问 socialneuron.com/pricing 注册。

权限范围

每个 API 密钥都会继承你套餐中的权限范围。工具需要特定权限范围才能执行。

CLI 参考

这些命令可直接在终端中运行，无需 AI Agent。适用于脚本、CI/CD 和快速检查。

全局安装（npm i -g @socialneuron/mcp-server）后，可直接使用 socialneuron-mcp。 否则，请在命令前加上 npx @socialneuron/mcp-server。

# Auth
socialneuron-mcp login [--device|--paste]
socialneuron-mcp logout

# Deterministic CLI (no LLM)
socialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm
socialneuron-mcp sn status --job-id <id>
socialneuron-mcp sn posts --days 7 --platform youtube
socialneuron-mcp sn refresh-analytics
socialneuron-mcp sn preflight --check-urls
socialneuron-mcp sn oauth-health --json
socialneuron-mcp sn oauth-refresh --platform instagram
socialneuron-mcp sn quality-check --content "your text here"
socialneuron-mcp sn autopilot
socialneuron-mcp sn usage
socialneuron-mcp sn loop
socialneuron-mcp sn credits

# Agent-native CLI v2
socialneuron-mcp sn tools [--module ideation] [--scope mcp:write]  # List/filter available tools
socialneuron-mcp sn info                                            # Version, auth, credits, tool count
socialneuron-mcp sn plan list|view|approve                          # Content plan management
socialneuron-mcp sn preset list|show|save|delete                    # Platform presets (6 built-in)

# Interactive REPL
socialneuron-mcp repl

# Add --json to any command for machine-readable output

自动化流程（端到端循环）

使用 MCP 工具实现完整的自主内容循环：

1. get_loop_summary — 评估项目状态（内容数量、已排期帖子、洞察）
2. plan_content_week — 根据洞察和趋势生成内容计划
3. generate_video / generate_image — 根据计划创建媒体资源
4. check_status — 轮询异步任务，直到资源就绪
5. schedule_post — 将内容分发到已连接的平台
6. （等待分析数据收集） — 平台数据会自动获取
7. refresh_platform_analytics — 手动触发分析数据刷新
8. get_performance_insights — 查看哪些做法有效、哪些无效
9. 使用新洞察返回步骤 1，开始下一轮循环

随着绩效数据反馈到规划步骤，每轮迭代都会产出更优质的内容。

安全

• 所有 API 密钥在存储前都会经过哈希处理，我们绝不会存储明文密钥
• 凭据存储在操作系统密钥链（macOS Keychain、Linux secret-tool）或环境变量中
• 所有 URL 参数均提供 SSRF 防护，并防止 DNS 重绑定
• 按用户实施速率限制，并针对高成本操作设置单工具限制
• Agent 循环检测可防止自动化失控
• 设置 DO_NOT_TRACK=1 可停用匿名使用情况遥测

请参阅 SECURITY.md，了解我们的漏洞披露政策和凭据安全详情。

遥测

此软件包会收集运行使用指标（工具名称、耗时、成功/失败），以提升可靠性。它不会发送工具输入、输出、生成内容、API 密钥、电子邮件或上游错误正文。部署配置 POSTHOG_PSEUDONYMIZATION_KEY 时，用户标识符会经过 HMAC 假名化处理；否则会使用每个进程独有的临时密钥，避免跨会话稳定关联。

停用方式：在环境中设置 DO_NOT_TRACK=1 或 SOCIALNEURON_NO_TELEMETRY=1。

我们绝不会收集个人内容、API 密钥或请求负载。

示例

有关由提示词驱动的工作流模板，请参阅 示例仓库：

• 每周批量规划内容
• 跨平台改编内容
• 绩效评审与优化循环
• 符合品牌风格的内容生成
• 评论互动自动化

链接

• Social Neuron
• 开发者页面
• 文档
• 示例
• Agent 协议
• 开发者设置
• 定价

许可证

MIT - 参见 LICENSE