nativine

@nativine/mcp — Nativine MCP サーバー

Nativine の公式 Model Context Protocol（MCP） サーバーです。MCP に対応した、初のウェブサイトからアプリへの変換プラットフォームです。

AI IDE（Cursor、Claude Desktop、Antigravity、VS Code、Windsurf、または MCP 対応ツール）を接続し、自然言語でのチャットを通じて、あらゆるウェブサイトをネイティブの Android（.apk／.aab）または iOS（.ipa）アプリに変換できます。

---

🚀 クイックスタート

1. API キーを取得する

Nativine ダッシュボードの「API Keys」タブから API キーを生成します。

2. IDE を設定する

MCP の設定に以下を追加します。

Cursor／Claude Desktop／Antigravity（mcp_config.json）：

{
  "mcpServers": {
    "nativine": {
      "command": "npx",
      "args": ["-y", "@nativine/mcp"],
      "env": {
        "NATIVINE_API_KEY": "ntvn_ak_your_key_here"
      }
    }
  }
}

VS Code（.vscode/settings.json）：

{
  "mcp.servers": {
    "nativine": {
      "command": "npx",
      "args": ["-y", "@nativine/mcp"],
      "env": {
        "NATIVINE_API_KEY": "ntvn_ak_your_key_here"
      }
    }
  }
}

3. アプリの作成を開始する

AI に話しかけるだけです。

「https://my-store.com を青いテーマと下部ナビゲーション付きの Android アプリに変換してください」

---

🔧 利用可能なツール

ツール	説明
nativine_get_account	認証済みユーザーのプロフィール、プランの種類、通貨を取得します
nativine_list_drafts	認証済みユーザーのすべてのアプリのドラフトを一覧表示します
nativine_get_draft	特定のアプリのドラフトの詳細をすべて取得します
nativine_save_draft	アプリのドラフト設定を作成または更新します
nativine_upload_asset	ローカルファイル（アイコン、スプラッシュ画像、ロゴ）を Nativine クラウドにアップロードします
nativine_trigger_build	ドラフトの APK／AAB／IPA のコンパイルを開始します
nativine_build_status	ビルドの進行状況を確認し、ダウンロードリンクを取得します
nativine_download_build	完了したビルドをローカルファイルシステムにダウンロードします

---

🔄 仕組み

1. 認証 — サーバーは環境変数から NATIVINE_API_KEY を読み込みます。
2. ドラフトの一覧表示または作成 — AI は nativine_list_drafts を呼び出して既存のアプリを表示するか、nativine_save_draft で新しいドラフトを作成します。
3. アプリの設定 — ブランドカラー、権限、スプラッシュ画面、下部ナビゲーション、ディープリンク、プッシュ通知、および30以上のネイティブ機能を設定します。
4. アセットのアップロード — ローカルファイルシステムからアプリアイコンやスプラッシュ画像を直接アップロードします。
5. ビルド — nativine_trigger_build でコンパイルを開始し、nativine_build_status で状況を確認します。
6. ダウンロード — 完了すると、AI が .apk／.aab／.ipa をプロジェクトディレクトリにダウンロードします。

---

📋 設定オプション

nativine_save_draft ツールは、以下のカテゴリを含む豊富な config オブジェクトを受け取ります。

• ブランディング — brandColor、statusBarColor、navBarColor、splashBackgroundColor
• スプラッシュ画面 — splashType（logo/full/animation）、splashLogoSize、splashAnimationType
• 動作 — screenOrientation、enablePullToRefresh、enableProgressBar、enablePinchToZoom、pressAgainToExit、enableFullScreen
• 権限 — enableCamera、enableMicrophone、enableLocation、enableStorage（カスタムのダイアログテキスト付き）
• ウェブの上書き設定 — userAgent、customCSS、customJS、supportedDomains
• ディープリンク — enableDeepLinks、deepLinkScheme、enableUniversalLinks
• アドオン — 下部ナビゲーション、ヘッダーバー、フローティングボタン、OneSignal プッシュ通知、AdMob 広告、生体認証、触覚フィードバック、アプリ内アップデート／レビュー、ローカルデータストア、連絡先へのアクセス、印刷サポート、OAuth／Google サインイン、スクリーンショットブロッカー
• キーストア — Play ストアでのリリース用のカスタム .jks／.p12 署名（Release プランのみ）
• バージョン管理 — versionCode、versionName

---

💳 プラン

機能	無料プラン	リリースプラン
トライアル APK のビルド	✅	✅
本番用 APK/AAB	❌	✅
iOS IPA のビルド	❌	✅
プッシュ通知	❌	✅
AdMob 広告	❌	✅
カスタムキーストア	❌	✅
生体認証とプレミアムアドオン	❌	✅

リリースプランに加入していない状態でプレミアム機能がリクエストされた場合、アシスタントがアップグレードをご案内します。nativine.com/pricing からいつでもアップグレードできます。

---

🌐 環境変数

変数	必須	説明
NATIVINE_API_KEY	✅	Nativine API キー（ntvn_ak_...）
NATIVINE_API_URL	❌	カスタム API エンドポイント（デフォルト：https://api.nativine.com/api）
NATIVINE_PROJECT_DIR	❌	ローカル設定とダウンロードに使用するプロジェクトディレクトリを上書きします

---

📖 ドキュメント

完全なドキュメントは nativine.com/docs でご覧いただけます。

MCP 固有のセットアップガイドは、nativine.com/mcp をご覧ください。

---

📄 ライセンス

ISC