ViralNote

@viralnote/mcp-server

ViralNote ソーシャルメディア API 向けの Model Context Protocol サーバーです。

Claude Desktop、Claude Code、Cursor、その他の MCP 対応ホストに接続すると、エージェントは X、Instagram、Facebook、TikTok、LinkedIn、YouTube、Pinterest、Bluesky、Threads、Reddit で、投稿の予約、メディアの管理、分析データの確認をネイティブな MCP ツール呼び出しとして行えます。接続用のコードは不要です。

インストール

Gemini CLI

このリポジトリから拡張機能をインストールします。

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

Gemini CLI を再起動し、/mcp auth viralnote を実行して ViralNote アカウントにサインインし、接続を認証します。この拡張機能は OAuth を使用するホスト型 HTTP サーバーを利用するため、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

ウィザードでは、保存する前に認証情報を入力します。セットアップ手順と API キーを使う方法については、llms-install.md を参照してください。自動承認は無効のままにし、変更を加える前に読み取り操作で接続を確認してください。

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 で生成します。posts:read、posts:write を付与してください。エージェントが Webhook を管理する場合は、webhooks:* も付与します。
VIRALNOTE_API_BASE	いいえ	https://viralnote.app/api/v1	ステージング環境／セルフホスト可能なインスタンスで上書きします。

公開されるツール

ツール	用途
list_posts	投稿を一覧表示します（ステータス／プラットフォームで絞り込み、ページネーションに対応）
get_post	プラットフォームごとの公開結果を含む、1件の投稿を読み込みます
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 に記載されています。

エージェント向けプロンプトの例

「直近の予約投稿を5件表示してください。」 ツール：list_posts に { status: "scheduled", limit: 5 } を指定します。

「このキャプションを、昨日アップロードした写真を添付して、明日の午前9時に Instagram に予約投稿してください。」 ツール：list_media → 項目を検索 → create_post に { platforms: ["instagram"], caption, libraryItemId, scheduledFor, status: "scheduled" } を指定します。

「この 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 をご覧ください。プルリクエストを歓迎します。