93개의 전문 도구를 사용하여 AI 클라이언트가 여러 플랫폼에 걸쳐 소셜 미디어 콘텐츠를 생성, 예약, 배포 및 분석할 수 있도록 지원합니다.
다른 이름 socialneuron/mcp-server, @socialneuron/mcp-server
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.6.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
Social Neuron MCP란?
Social Neuron은(는) MCP server입니다. 93개의 전문 도구를 사용하여 AI 클라이언트가 여러 플랫폼에 걸쳐 소셜 미디어 콘텐츠를 생성, 예약, 배포 및 분석할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Social Neuron MCP server 정보
이 MCP server는 콘텐츠 크리에이터와 마케팅 팀이 AI 에이전트를 통해 소셜 미디어 활동을 관리할 수 있게 해줍니다. Claude Code, Cursor 또는 Claude Desktop과 같은 클라이언트에 연결하면 93개의 전문 도구를 활용하여 콘텐츠 라이프사이클 전체를 처리할 수 있습니다. 시스템은 비디오, 이미지, 음악, 보이스오버 생성뿐만 아니라 X, Bluesky, YouTube, TikTok과 같은 플랫폼에 게시물을 예약하는 기능도 지원합니다.
설정을 위해서는 Social Neuron Pro 플랜 이상의 구독이 필요하며, 디바이스 코드, 브라우저 플로우 또는 API key를 통한 인증이 필요합니다. 연결이 완료되면 아이디어 구상, 브랜드 보이스 관리, 댓글 중재를 통한 자동화된 참여 관리 도구를 사용할 수 있습니다. 또한 반복 게시를 위한 오토파일럿 및 지원되는 호스트에서 콘텐츠 캘린더나 분석 대시보드를 볼 수 있는 인터랙티브 앱과 같은 고급 기능도 포함되어 있습니다.
단순한 게시를 넘어, 이 MCP server는 폐쇄 루프 최적화 프로세스를 촉진합니다. 트렌드를 가져오고, 미디어 에셋을 생성하고, 콘텐츠를 배포한 다음, 성과 데이터를 분석하여 향후 계획을 위한 개선 사항을 제안할 수 있습니다. 이를 통해 AI가 플랫폼 분석 데이터를 학습하여 전략을 정교화하는 완전한 소셜 미디어 매니저 역할을 수행할 수 있습니다.
활용 사례
- 1콘텐츠 생성 자동화AI 클라이언트에게 브랜드에 맞는 비디오, 이미지, 캐러셀을 포함한 다양한 미디어 유형을 생성하도록 요청하세요.
- 2멀티 플랫폼 예약AI 에이전트에게 지정된 시간에 특정 게시물을 여러 소셜 네트워크에 배포하도록 지시하세요.
- 3성과 분석 및 최적화최근 소셜 미디어 지표를 검토하여 성과가 높은 콘텐츠와 개선이 필요한 부분을 식별하도록 요청하세요.
- 4자율 콘텐츠 루프트렌드 주제와 과거 성과를 기반으로 콘텐츠를 계획, 생성 및 게시하는 반복 시스템을 구축하세요.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Social Neuron MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Social Neuron MCP 설치
$ claude mcp add --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server -- npx -y @socialneuron/mcp-serverCursor에 Social Neuron MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}VS Code에 Social Neuron MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}VS Code CLI에 Social Neuron MCP 설치
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@socialneuron/mcp-server"],"env":{"SOCIALNEURON_API_KEY":"<YOUR_SOCIALNEURON_API_KEY>"}}'Claude Desktop에 Social Neuron MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}Codex에 Social Neuron MCP 설치
$ codex mcp add mcp-server --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' -- npx -y @socialneuron/mcp-serverCodex config.toml에 Social Neuron MCP 설치
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@socialneuron/mcp-server"] [mcp_servers.mcp-server.env] SOCIALNEURON_API_KEY = "<YOUR_SOCIALNEURON_API_KEY>"
Gemini CLI에 Social Neuron MCP 설치
$ gemini mcp add -s user -e 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server npx -- -y @socialneuron/mcp-serverGemini settings.json에 Social Neuron MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}구성
SOCIALNEURON_API_KEY필수비밀Your Social Neuron API key. Generate at https://socialneuron.com/settings/developer
| 이름 | 설명 | 유형 |
|---|---|---|
| SOCIALNEURON_API_KEY | Your Social Neuron API key. Generate at https://socialneuron.com/settings/developer | 필수비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기@socialneuron/mcp-server
93 public MCP tools for AI-powered social media management. Create content, schedule posts, track analytics, and optimize performance — all from Claude Code or any MCP client.
Quick Start
1. Authenticate
npx -y @socialneuron/mcp-server login --device
This opens your browser to authorize access. Requires a Social Neuron Pro plan or higher. See pricing.
2. Add to Claude Code
claude mcp add socialneuron -- npx -y @socialneuron/mcp-server
Add to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
Add to .cursor/mcp.json in your workspace:
{
"mcpServers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
3. Start using
Ask Claude: "What content should I post this week?" or "Schedule my latest video to YouTube and TikTok"
What You Can Do
Ask Claude things like:
- "Generate 5 content ideas about sustainable fashion for Gen Z"
- "Create a 30-second video ad for my product launch"
- "Schedule this post to X and Bluesky at 9am tomorrow"
- "Show me my best-performing content this month"
- "What are the trending topics in my niche right now?"
- "Check my analytics and suggest improvements"
- "Set up autopilot to post 3 times per week"
Tool Categories
The npm package exposes 93 public tools per transport. The separately versioned hosted service exposes 92 public tools, including hosted-only get_account_status. Hosted HTTP includes the Content Calendar and Analytics Pulse MCP Apps; npm stdio includes 2 local screen-capture tools instead. The live hosted count is published by the server card. The npm package supports Node 20.20+ and Node 22.22+ under its declared engine ranges. The hosted service runs its separate 3.0.0 contract; its version is recorded alongside its reviewed tool inventory in server.json.hosted.
These tools are available to AI agents (Claude, Cursor, etc.) via the MCP protocol.
Content Lifecycle
| Category | Tools | What It Does |
|---|---|---|
| Ideation | generate_content, fetch_trends, adapt_content, get_ideation_context | AI-powered content ideas and trend research |
| Content | generate_video, generate_image, generate_music, generate_voiceover, generate_carousel, check_status, create_storyboard | Video, image, music, voiceover, and carousel creation across multiple AI model families |
| Distribution | schedule_post, reschedule_post, schedule_content_plan, find_next_slots, list_connected_accounts, list_recent_posts | Project-scoped multi-platform publishing, scheduling, rescheduling, and slot optimization |
| Analytics | fetch_analytics, refresh_platform_analytics | Performance tracking across all platforms |
| Insights | get_performance_insights, get_best_posting_times | Data-driven content optimization |
Management & Optimization
| Category | Tools | What It Does |
|---|---|---|
| Brand | extract_brand, get_brand_profile, save_brand_profile, update_platform_voice | Brand identity and voice management |
| Comments | list_comments, reply_to_comment, post_comment, moderate_comment, delete_comment | Social engagement management |
| Lifecycle | cancel_async_job, cancel_scheduled_post, delete_carousel, delete_content_plan, delete_autopilot_config | Confirmed, project-scoped cancellation and cleanup with explicit refund status |
| Planning | plan_content_week, save_content_plan, get_content_plan, update_content_plan, submit_content_plan_for_approval | Content calendar and approval workflows |
| Plan Approvals | create_plan_approvals, respond_plan_approval, list_plan_approvals | Review and approve content plans |
| Autopilot | list_autopilot_configs, get_autopilot_status, update_autopilot_config | Automated content scheduling |
| Quality | quality_check, quality_check_plan | Pre-publish content validation |
| Credits | get_credit_balance, get_budget_status, get_generation_options | Usage and budget tracking |
| Loop | get_loop_summary | Closed-loop optimization feedback |
Utilities
| Category | Tools | What It Does |
|---|---|---|
| Extraction | extract_url_content | Extract content from URLs, YouTube, articles |
| Screenshots | capture_app_page, capture_screenshot | Visual documentation and monitoring |
| Remotion | list_compositions, render_demo_video | Programmatic video rendering |
| Usage | get_mcp_usage | API usage monitoring |
| YouTube | fetch_youtube_analytics | YouTube-specific deep analytics |
| Discovery | search_tools | Find tools by keyword with progressive detail levels (saves 98% tokens vs loading all tools) |
Interactive MCP Apps (hosted HTTP)
| App | Open tool | Purpose |
|---|---|---|
| Content Calendar | open_content_calendar |
Project-scoped calendar, quick create, and drag-to-reschedule |
| Analytics Pulse | open_analytics_pulse |
Project-scoped KPI, platform-mix, and top-post performance dashboard |
Apps render only in MCP hosts that support the MCP Apps extension. All underlying data and write operations remain ordinary scoped tools, so hosts without interactive UI can use the same workflows through text/tool calls.
Authentication
Three auth methods, in order of recommendation:
Device Code (Recommended)
npx -y @socialneuron/mcp-server login --device
Opens browser, you approve, CLI receives API key automatically.
Browser Flow
npx -y @socialneuron/mcp-server login
Browser-based OAuth flow.
API Key Paste
npx -y @socialneuron/mcp-server login --paste
Generate a key at socialneuron.com/settings/developer, paste it in.
Keys are stored in your OS keychain (macOS Keychain, Linux secret-tool) or a file fallback created with owner-only permissions where the operating system supports them.
Windows users: The file fallback (
~/.config/social-neuron/credentials.json) does not have strong permission enforcement on NTFS. For production use on Windows, set theSOCIALNEURON_API_KEYenvironment variable instead.
Pricing
MCP/API access requires a Pro plan or higher:
| Plan | Price | Credits/mo | MCP/API Access |
|---|---|---|---|
| Free | $0 | 50 | — |
| Starter | $19/mo | 500 | — |
| Pro | $49/mo | 1,500 | MCP/API: Read + Analytics + Write + Distribute |
| Team | $99/mo | 3,500 | Full MCP/API + 5 keys |
| Agency | $249/mo | 10,000 | Full MCP/API + 20 keys |
Sign up at socialneuron.com/pricing.
Scopes
Each API key inherits scopes from your plan. Tools require specific scopes to execute.
| Scope | What you can do |
|---|---|
mcp:read |
Analytics, insights, brand profiles, content plans, quality checks, screenshots, usage stats, credit balance |
mcp:write |
Generate content (video, image, voiceover, carousel), create storyboards, save brand profiles, plan content |
mcp:distribute |
Schedule posts, publish content plans |
mcp:analytics |
Refresh analytics, YouTube deep analytics |
mcp:comments |
List, reply, post, moderate, delete comments |
mcp:autopilot |
Configure and monitor automated scheduling |
mcp:full |
All of the above |
CLI Reference
These commands run directly in your terminal — no AI agent needed. Useful for scripts, CI/CD, and quick checks.
After global install (
npm i -g @socialneuron/mcp-server), usesocialneuron-mcpdirectly. Otherwise, prefix withnpx @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
Automation Flow (E2E Loop)
The full autonomous content loop using MCP tools:
get_loop_summary— assess project state (content count, scheduled posts, insights)plan_content_week— generate a content plan based on insights and trendsgenerate_video/generate_image— create media assets from the plancheck_status— poll async jobs until assets are readyschedule_post— distribute content to connected platforms- (wait for analytics collection) — platform data is fetched automatically
refresh_platform_analytics— trigger a manual analytics refreshget_performance_insights— read what worked and what didn't- Loop back to step 1 with new insights
Each iteration produces smarter content as performance data feeds back into the planning step.
Security
- All API keys are hashed before storage — we never store plaintext keys
- Credentials stored in your OS keychain (macOS Keychain, Linux secret-tool) or environment variable
- SSRF protection on all URL parameters with DNS rebinding prevention
- Rate limiting per user with per-tool limits for expensive operations
- Agent loop detection prevents runaway automation
- Set
DO_NOT_TRACK=1to disable anonymous usage telemetry
See SECURITY.md for our vulnerability disclosure policy and credential safety details.
Telemetry
This package collects operational usage metrics (tool name, duration, success/failure) to improve reliability. It does not send tool inputs, outputs, generated content, API keys, emails, or upstream error bodies. When a deployment configures POSTHOG_PSEUDONYMIZATION_KEY, the user identifier is HMAC-pseudonymized; otherwise an ephemeral per-process key prevents stable cross-session correlation.
To disable: Set DO_NOT_TRACK=1 or SOCIALNEURON_NO_TELEMETRY=1 in your environment.
No personal content, API keys, or request payloads are ever collected.
Examples
See the examples repo for prompt-driven workflow templates:
- Weekly content batch planning
- Cross-platform content repurposing
- Performance review and optimization loops
- Brand-aligned content generation
- Comment engagement automation
Use Social Neuron in your assistant
This npm package is one of several ways to connect. The Social Neuron organization page keeps the current table for Grok Build, ChatGPT, Claude, Cursor and local MCP clients, with the status of each listing.
The Grok Build plugin lives in this repository at plugins/socialneuron/. It uses the hosted server with browser sign-in and adds skills. Its connection is named socialneuron-hosted, so it can be set up alongside this npm server, and it is versioned separately from the npm package. Free MIT plugin; requires a Social Neuron account. Generation uses your plan's credits.
Links
License
MIT - see LICENSE
Social Neuron MCP 질문
Social Neuron MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server -- npx -y @socialneuron/mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Social Neuron MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
어떤 종류의 콘텐츠를 생성할 수 있나요?
이 MCP server는 다양한 AI 모델 제품군을 사용하여 비디오, 이미지, 음악, 보이스오버 및 캐러셀을 생성하는 도구를 제공합니다.
유료 구독이 필요한가요?
네, MCP 및 API 액세스를 위해서는 Social Neuron Pro 플랜 이상의 구독이 필요합니다.
소셜 미디어 게시물을 자동화할 수 있나요?
네, 오토파일럿을 설정하여 콘텐츠를 정해진 일정에 따라 게시하거나, X 및 Bluesky와 같은 플랫폼에서 콘텐츠를 계획하고 예약하는 도구를 사용할 수 있습니다.