nativine

@nativine/mcp — Nativine MCP 服务

Nativine 官方的 Model Context Protocol (MCP) 服务——Nativine 是首个支持 MCP 的网站转应用平台。

连接你的 AI IDE（Cursor、Claude Desktop、Antigravity、VS Code、Windsurf，或任何兼容 MCP 的工具），通过自然语言聊天将任意网站转换为原生 Android（.apk/.aab）或 iOS（.ipa）应用。

---

🚀 快速开始

1. 获取 API 密钥

从 Nativine Dashboard → 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 Store 发布配置自定义 .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