关键词

旅行规划协作管理云基础设施AI助手移动出行

项目简介

Chravel是一款功能丰富的旅行规划与协作移动应用，旨在帮助用户高效管理个人旅行、团队差旅及各类活动。它支持移动原生功能、离线优先架构，并深度集成了AI礼宾和Render云基础设施管理功能，为用户提供智能化的出行与工作体验。

主要功能点

  • 旅行与活动管理: 创建、编辑和组织个人旅行、专业差旅和各种活动，包括详细的行程、参与者和地点信息。
  • 协作与通信: 通过应用内聊天、广播消息和支付请求功能，与同行者、团队成员或活动参与者进行实时沟通和高效协作。
  • 移动优先体验: 提供iOS和Android原生应用，充分利用设备功能，如相机、推送通知、地理定位、离线模式和后台数据同步，确保流畅的用户体验。
  • AI礼宾服务: 内置由Google Gemini提供支持的AI助手，能够为用户提供个性化的旅行建议、信息查询和任务协助。
  • Render云基础设施管理 (MCP服务器功能): 作为Model Context Protocol (MCP) 服务器，Chravel允许支持MCP协议的大语言模型（LLM）客户端（例如Cursor IDE）通过自然语言命令直接管理Render云平台上的Web服务、静态站点和数据库。这包括监控日志、实时分析服务指标、直接查询Render Postgres数据库以及更新服务配置和环境变量。

安装步骤 (适用于开发者)

  1. 克隆仓库: 
    git clone <YOUR_GIT_URL>
    （请替换 '<YOUR_GIT_URL>' 为您获取的仓库地址）
  2. 进入项目目录: 
    cd <YOUR_PROJECT_NAME>
    （请替换 '<YOUR_PROJECT_NAME>' 为实际的项目文件夹名称）
  3. 安装依赖: 
    npm i
  4. 配置环境变量: 复制项目根目录下的 '.env.example' 文件，并将其重命名为 '.env'。 
    cp .env.example .env
    然后编辑 '.env' 文件，根据您的实际情况添加以下必要的API密钥：
    • 'VITE_GOOGLE_MAPS_API_KEY': 用于地图和地点功能（在Google Cloud Console中启用Maps JavaScript API, Places API, Geocoding API）
    • 'VITE_SUPABASE_URL' 和 'VITE_SUPABASE_ANON_KEY': 用于数据库连接
    • 'LOVABLE_API_KEY': 用于AI礼宾服务（由Google Gemini提供支持）
    • 'VITE_STREAM_API_KEY': 用于聊天功能
    • 'SUPABASE_URL' 和 'SUPABASE_SERVICE_ROLE_KEY': 用于后端Supabase函数
  5. 启动开发服务器: 
    npm run dev
    这将启动一个本地开发服务器，并提供即时预览。
  6. （可选）移动平台设置: 如果您想构建原生iOS/Android应用，请按照以下步骤操作：
    • 添加原生平台: 
      npx cap add ios
npx cap add android
    • 构建Web资源: 
      npm run build
    • 同步到原生平台: 
      npx cap sync
    • 在原生IDE中打开 (需要Xcode或Android Studio): 
      npx cap open ios      # 仅限Mac
npx cap open android

服务器配置 (适用于LLM客户端用户)

您的MCP客户端（例如Cursor IDE）可以通过以下JSON格式的配置信息连接到Chravel MCP服务器：

{
  "server_name": "Chravel Render MCP Server",
  "command": "npm",
  "args": ["run", "claude"]
}

配置参数说明:

  • 'server_name': 这是在您的MCP客户端界面中，Chravel服务器将显示的友好名称，方便您识别。
  • 'command': 用于启动Chravel MCP服务器进程的Shell命令。在这里，我们使用'npm'作为主要的执行器，因为它是一个Node.js项目。
  • 'args': 传递给'command'的命令行参数列表。'["run", "claude"]'指示'npm'执行'package.json'中定义的'claude'脚本，该脚本专门负责启动具有高级代码分析和MCP集成功能的Claude Code服务。

基本使用方法 (通过MCP客户端)

  1. 启动Chravel MCP服务器: 请确保您已按照上述“安装步骤”配置好Chravel项目，并在项目根目录下运行 'npm run claude' 命令，以启动包含MCP集成功能的Claude Code服务。
  2. 配置MCP客户端: 在您的LLM客户端（如Cursor IDE）中，找到MCP服务器配置或类似的外部工具集成设置，并填入上述“服务器配置”中的JSON信息。
  3. 重启客户端: 根据LLM客户端的要求，可能需要重启客户端以使新的MCP服务器配置生效。
  4. 开始自然语言交互: 配置完成后，您便可以在LLM客户端中使用自然语言提示来管理您的Render基础设施。例如：
    • "Show me my Render services" （显示我在Render上的所有服务）
    • "What's the CPU usage for my web service 'my-app'?" （我的'my-app' Web服务CPU使用率是多少？）
    • "Create a new Postgres database on Render" （在Render上创建一个新的Postgres数据库）
    • "Update environment variable 'API_KEY' to 'new-value' for service 'my-api'" （将'my-api'服务的环境变量'API_KEY'更新为'new-value'） Chravel MCP服务器将解释这些指令，并执行相应的Render操作或返回信息。

信息

分类

开发者工具

访问项目