Napkin

@mindstone/mcp-server-napkin

Model Context Protocol ホスト向けの Napkin AI ビジュアル生成 MCP サーバーです。テキストの説明から図、インフォグラフィック、イラストなどのプロフェッショナルなビジュアルを生成し、生成状況を確認して、標準化された MCP インターフェースを通じて結果をダウンロードできます。

ステータス

• バージョン： 0.4.1 · npm
• 認証： API キー（NAPKIN_API_KEY）
• ツール： 5（ビジュアル、ダウンロード、スタイル）
• 接続先： クラウド API
• 機械可読： STATUS.json

注： Napkin API は現在、開発者向けプレビューです（api.napkin.aiを参照）。エンドポイントや動作は変更される可能性があります。上流への問題報告は [email protected] までお寄せください。以前のガイドでは context_before／context_after パラメーターが参照されていますが、Napkin はこれらを廃止し、単一の context パラメーターに置き換えました。napkin_generate_visual はこのパラメーターに対応しています。

必要条件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから NAPKIN_API_KEY と NAPKIN_REQUEST_TIMEOUT_MS の入力を求められます。

{
  "mcpServers": {
    "Napkin": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-napkin"
      ],
      "env": {
        "NAPKIN_API_KEY": "",
        "NAPKIN_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/napkin
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-napkin

ローカル

node dist/index.js

設定

環境変数

• NAPKIN_API_KEY — Napkin AI API キー
• MCP_WORKSPACE_PATH — 生成したビジュアルの保存先となる、任意のワークスペースパス
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用する、ホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のある別名
• NAPKIN_REQUEST_TIMEOUT_MS — Napkin API、ホストブリッジ、ダウンロード呼び出しに適用される送信 HTTP リクエストタイムアウトの任意の上書き値（正の整数のミリ秒、最大 30 分）。デフォルト：60000（60 秒）。送信処理が遅い場合やダウンロードサイズが大きい場合に TIMEOUT エラーが発生するなら、この値を大きくしてください。より厳密な制限が必要な場合は小さくしてください。

ホスト設定例

Claude Desktop／Cursor

{
  "mcpServers": {
    "Napkin": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-napkin"],
      "env": {
        "NAPKIN_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発（npm 公開は不要）

{
  "mcpServers": {
    "Napkin": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/napkin/dist/index.js"],
      "env": {
        "NAPKIN_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（5）

設定

• configure_napkin_api_key — Napkin AI API キーを設定します

生成

• napkin_generate_visual — テキストからプロフェッショナルなビジュアルを生成します
• napkin_check_status — ビジュアル生成リクエストのステータスを確認します（ベンダー作成の自由記述テキスト（警告／エラーメッセージおよび visual_query）は、ホストがデータとして扱うよう <untrusted-content> エンベロープで囲まれます。コード、ID、URL はそのまま保持され、機械識別子の文字セットはレスポンスの検証によって強制されます）
• napkin_download_visual — 生成されたビジュアルファイルをディスクにダウンロードします（既存のファイルは上書きされません。別の filename を指定するか、省略して自動生成してください）。リダイレクト先へ移動する前に、Napkin のホスト許可リストに照らして再検証されます。許可リストにないリダイレクト先は拒否されます。

スタイル

• napkin_list_styles — Napkin に組み込まれた 15 種類のビジュアルスタイル（ID、説明、カテゴリ）を一覧表示し、napkin_generate_visual に指定する style_id を選択できます。静的カタログのため、API キーやネットワーク呼び出しは不要です。

ライセンス

FSL-1.1-MIT — Functional Source License Version 1.1。将来的に MIT ライセンスへ移行します。ソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。