Web到iOS MCP
MCP服务器，用于使用Capacitor将web应用程序（Vite/Next.js/React）转换为iOS应用程序。
概要
Web到iOS MCP 是现有的Web应用程序iOS为了转换成应用程序MCP服务器。Vite、Next.js、Create React App等框架Capacitor使用iOS自动生成化的详细规格书和配置文件。
主要功能
🔍 1.框架自动检测
- 快速+反应/查看: package.json和vite.config.ts的明细栏样式中定义的设置
- Next.js: App Router / Pages Router发现
- 创建React应用程序: react-scripts发现
- 其他: Parcel, Webpack等
検出内容：
- 框架名称和版本
- 构建输出目录
- 路由选择
- 正在使用的主要库（React Router、Supabase等）
📝 2. iOS变换仕样书の自动生成
根据项目配置生成详细的规格书，包括：
- 当前技术栈分析
- Capacitor安装说明
- 特定于框架的设置更改（按Vite/NNext.js）
capacitor.config.ts建议package.json添加到脚本- iOS固有の最适化（Safe Area、Status Bar等）
- 故障排除指南
⚙️ 3.自动生成配置文件
capacitor.config.ts：为项目优化的设置- 构建设置更改建议
.gitignore附加项
✅ 4.迁移准备核对表
- Xcode确认环境
- CocoaPods安装状态
- 确认所需的依赖关系
- 确认构建成功
用法
MCP资源
这MCP服务器将以下文档MCP作为资源提供。Claude Code对较大场景进行渲染期间已观察到该故障。
web-to-ios://guides/implementation
实施指南 - iOS迁移实施指南
提供完整的实施指南：
- 实施前的问题整理和风险管理
- 设计原则（KISS、YAGNI、Fail Fast等）
- 性能优化最佳实践
- 质量检查表
- MVP（Minimum Viable Product）定义
web-to-ios://guides/troubleshooting
常见问题及解决方案 -故障排除指南
包括常见问题和解决方案：
- 构建错误（CocoaPods、Xcode签名等）
- 运行时错误（白色屏幕、路由、环境变量）
- Vite特有の问题（base设定、HMR等）
- Next.js特有の问题（Static Export、画像最适化等）
- Supabase协作问题
- UI/UX问题（Safe Area、状态栏、键盘）
- 性能问题
MCP工具
detect_web_framework
Web检测项目的框架和配置。
入力:
projectPath：项目目录路径
出力:
{
"framework": "vite",
"version": "5.0.0",
"uiLibrary": "react",
"buildOutputDir": "dist",
"routing": "react-router",
"dependencies": {
"supabase": "^2.78.0",
"tailwindcss": "^3.4.0"
}
}generate_ios_migration_spec
iOS生成用于转换的详细规格说明书。
入力:
projectPath：项目目录路径appName：应用程序名称（例如“Spark Vault”）bundleId：捆绑包ID（例如：“com.ogadix.sparkvault”）
出力:
- Markdown形式的详细式样书
generate_capacitor_config
Capacitor生成配置文件。
入力:
appName：应用程序名称appId：捆绑IDwebDir：构建输出目录（例如“dist”）framework：框架名称（例如“vite”）
出力:
capacitor.config.ts文件内容
analyze_migration_readiness
iOS检查迁移的就绪性。
入力:
projectPath：项目目录路径
出力:
{
"ready": false,
"checks": [
{ "name": "Xcode installed", "status": "pass" },
{ "name": "CocoaPods installed", "status": "pass" },
{ "name": "Build successful", "status": "fail", "message": "npm run build failed" }
]
}支持的框架
✅ 已对应（v1.0）
- Vite+反应
- 快速+查看
- Next.js （应用路由器/页面路由器）
- 创建React应用程序
🔜 今后对应予定
- 星的
- SvelteKit 的
- 混音
- Nuxt.js
技术栈
- TypeScript: 型安全性
- Node.js：実行环境
- MCP-SDK:
@modelcontextprotocol/sdk - 从属库:
- fs-extra：文件操作 - glob：文件搜索 - JSON/YAML 解析器
安装
# NPMで公開後
npm install -g web-to-ios-mcp
# または、ローカル開発
git clone https://github.com/Gaku52/web-to-ios-mcp.git
cd web-to-ios-mcp
npm install
npm run build开发路线图
Phase 1: 基本机能（v1.0）
- \[x\] 项目构想及规格制定
- \[\]框架检测功能
- \[ \] Vite検出 - \[ \] Next.js検出 - \[ \] CRA検出
- \[ \] iOS仕样书生成
- \[ \] Vite的模板 - \[ \] Next.js的模板
- \[ \] Capacitor设定生成
- \[\]迁移准备检查
- \[\]创建测试用例
- \[\]文档维护
Phase 2: 扩张机能（v1.1+）
- \[\]更详细的依存关系分析
- \[\]自定义插件推荐功能
- \[\]故障诊断自动诊断
- \[\]现有iOS项目发现和更新
Phase 3: Android対応（v2.0）
- 将显示
web-to-mobile-mcp变更复核 - \[ \] Android变换机能追加
- \[ \] iOS/Android共通设定の最适化
分发
欢迎分享！
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
MIT License - 详情 许可证 的双曲正切值
作者
学术论文52
相关项目
______________________________________________________________________
Web to iOS MCP 那么，你的Web简化应用程序iOS到应用程序。