AI导哈

旅行应用MCP服务器

一个基于Python的模型上下文协议（MCP）服务器，专为Luvya旅行应用设计，集成了Supabase数据库，提供行程管理、事件处理和通知功能。

  • by joshuablyth05
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 joshuablyth05/luvya-python-mcp

使用说明

Luvya MCP服务器

为Luvya旅行应用开发的基于Python的模型上下文协议（MCP）服务器，已集成Supabase。

特点/功能

  • MCP 工具获取行程、创建行程、管理活动、处理通知
  • 交互式小部件用于行程、活动和通知的HTML小部件
  • Supabase 集成直接连接到您的旅行应用数据库
  • OAuth 准备就绪支持ChatGPT集成的身份验证

快速入门

  1. 安装依赖项:

    pip install -r requirements.txt

  2. 配置环境:

    cp .env.example .env
# Edit .env with your Supabase credentials

  3. 运行服务器：

    python luvya_server.py

可用的MCP工具

  • hello_world() - 测试连接
  • get_trips() - 列出所有行程
  • create_trip(title, description, start_date, end_date, user_id) - 创建新行程
  • get_trip_events(trip_id) - 获取旅行的事件信息
  • create_trip_event(trip_id, title, description, event_date, location) - 创建旅行活动
  • get_notifications(user_id) - 获取用户通知
  • mark_notification_read(notification_id) - 将通知标记为已读

MCP资源（小部件）

  • trips-widget - 互动式旅行管理
  • events-widget - 旅行活动管理
  • notifications-widget - 通知管理

连接到ChatGPT

  1. 获取您的MCP服务器URL： http://localhost:3000/mcp （当部署时）
  2. 在ChatGPT中启用开发者模式 → 创建连接 → 输入MCP URL
  3. 测试“用我的应用来打招呼吧！”

部署

铁路（推荐）

# Install Railway CLI
npm install -g @railway/cli

# Deploy
railway login
railway deploy

Vercel（音译，也可根据上下文意译为“弗塞尔”等，但通常直接使用音译）

# Install Vercel CLI
npm install -g vercel

# Deploy
vercel --prod

渲染

  1. 连接GitHub仓库
  2. 设置构建命令： pip install -r requirements.txt
  3. 设置启动命令： python luvya_server.py
  4. 添加环境变量

环境变量

  • SUPABASE_URL - 您的Supabase项目URL
  • SUPABASE_ANON_KEY - 您的Supabase匿名密钥
  • JWT_SECRET - JWT签名的秘密密钥（可选）

发展

服务器使用FastMCP，它能够自动从Python类型提示和文档字符串生成工具定义。这使得添加新工具和维护代码库变得非常容易。

故障排除

  • 服务器无法连接检查Supabase凭据 .env
  • 工具无法正常工作验证数据库表是否存在于Supabase中
  • 小部件未加载检查浏览器控制台中的错误

许可证

麻省理工学院许可证

相关 MCP