Luvya Python MCP

Luvya MCP服务器

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

特点/功能

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

快速入门

1. 安装依赖项:

   pip install -r requirements.txt

1. 配置环境:

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

1. 运行服务器：

   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中
• 小部件未加载检查浏览器控制台中的错误

许可证

麻省理工学院许可证