ViralNote

@viralnote/mcp-server

适用于 ViralNote 社交媒体 API 的 Model Context Protocol 服务。

将它接入 Claude Desktop、Claude Code、Cursor 或任何支持 MCP 的宿主，你的 Agent 就能通过原生 MCP 工具调用，在 X、Instagram、Facebook、TikTok、LinkedIn、YouTube、Pinterest、Bluesky、Threads 和 Reddit 上安排帖子发布、管理媒体并读取分析数据。无需编写胶水代码。

安装

Gemini CLI

从此代码仓库安装扩展：

gemini extensions install https://github.com/viralnote/mcp-server

重启 Gemini CLI，然后运行 /mcp auth viralnote，登录你的 ViralNote 账户并授权连接。该扩展使用托管的 HTTP 服务和 OAuth；无需 API 密钥或本地构建服务。可以先执行只读操作，例如“列出我已连接的社交账号”。

Cline

在 Cline 的 MCP Servers 界面中，添加名为 viralnote 的远程 Streamable HTTP 服务，地址为 https://dashboard.viralnote.app/api/mcp/mcp，然后完成 OAuth 登录。对于 Cline CLI，请运行：

cline mcp install viralnote --transport http https://dashboard.viralnote.app/api/mcp/mcp

向导会在保存前询问身份验证详情。请参阅 llms-install.md，了解设置流程和 API 密钥替代方案。请保持自动批准处于禁用状态，并先通过只读操作验证连接，再进行更改。

Claude Desktop / Claude Code / Cursor

添加到 MCP 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，其他平台上的路径类似）：

{
  "mcpServers": {
    "viralnote": {
      "command": "npx",
      "args": ["-y", "@viralnote/mcp-server"],
      "env": {
        "VIRALNOTE_API_KEY": "vnd_..."
      }
    }
  }
}

重启 MCP 宿主。ViralNote 工具将立即可用。

此代码仓库包含根目录下的 .mcp.json（遵循 Open Plugins 标准），因此 Cursor Directory 等工具可以通过 GitHub URL 自动检测 MCP 服务。

Cursor Marketplace

插件在 Cursor Marketplace 发布后，你可以直接从 Cursor 安装：

1. 打开 Cursor，进入 Settings → Plugins
2. 在 Marketplace 中搜索“ViralNote”
3. 点击 Install
4. 在 Plugins → Configure 中设置你的 VIRALNOTE_API_KEY
5. 从 dashboard.viralnote.app 或 viralnote.app/developers/auth 获取 API 密钥

ViralNote 工具将在你的 Cursor 环境中立即可用。

本地安装

npm install -g @viralnote/mcp-server

然后在 MCP 配置中直接引用 viralnote-mcp：

{
  "mcpServers": {
    "viralnote": {
      "command": "viralnote-mcp",
      "env": { "VIRALNOTE_API_KEY": "vnd_..." }
    }
  }
}

配置

环境变量	必需	默认值	说明
VIRALNOTE_API_KEY	是	—	在 viralnote.app/developers/auth 生成。如果 Agent 需要管理 webhook，请授予 posts:read、posts:write，以及 webhooks:* 权限。
VIRALNOTE_API_BASE	否	https://viralnote.app/api/v1	用于覆盖暂存环境或可自托管实例的地址。

暴露的工具

工具	用途
list_posts	列出帖子（按状态／平台筛选，支持分页）
get_post	读取单条帖子，包括各平台的发布结果
create_post	创建草稿（is_draft: true）或定时发布的帖子
update_post	更新草稿或定时发布的帖子
delete_post	删除（如果已安排发布，则取消发布）
publish_post	立即发布草稿
list_media	列出媒体库项目
import_media	通过 URL（200MB）或 base64 数据（3MB）导入
delete_media	删除媒体项目
list_social_accounts	列出已连接的社交账号
list_analytics	查看已发布帖子的各平台指标
list_post_results	查看各平台的投递结果（成功／错误）
list_webhooks	列出 Webhook 订阅
create_webhook	订阅事件
delete_webhook	取消订阅

对于大多数用户来说，使用 位于 https://viralnote.app/api/mcp/mcp 的 HTTP MCP 服务比安装此 stdio 包更简单——HTTP 配置示例请参阅 https://viralnote.app/developers/mcp。如果你的 MCP 客户端不支持 HTTP 传输，请使用此 stdio 包。

底层 REST 端点以及请求／响应格式参见 viralnote.app/developers/docs。

Agent 提示词示例

“显示我最近安排的 5 条帖子。” 工具：使用 { status: "scheduled", limit: 5 } 调用 list_posts。

“将这段配文安排在明天上午 9 点发布到 Instagram，并附上我昨天上传的照片。” 工具：list_media → 查找项目 → 使用 { platforms: ["instagram"], caption, libraryItemId, scheduledFor, status: "scheduled" } 调用 create_post。

“将这个 Dropbox 链接导入我的媒体库，然后立即发布到 X。” 工具：import_media → create_post（草稿）→ publish_post。

开发

git clone https://github.com/viralnote/mcp-server
cd mcp-server
npm install
npm run build
VIRALNOTE_API_KEY=vnd_... npm start

如需本地迭代且不重新构建：

VIRALNOTE_API_KEY=vnd_... npm run dev

许可证

MIT——详见 LICENSE。欢迎提交拉取请求。