冬令营管理协议服务器

Aurora Camp Server是一个基于FastMCP构建的模型上下文协议(MCP)服务器,通过Knack API管理冬令营操作,支持搜索、创建、更新和管理营地、预订及注册儿童信息。

  • by M10546
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 M10546/Aurora-MCP-server

使用说明


🌌 极光营地服务器(Knack MCP)

Aurora Camp服务器是一个 模型上下文协议(MCP) 使用构建的服务器 快速MCP,旨在通过 克纳克API. 它使人工智能代理或工具能够以结构化和安全的方式搜索、创建、更新和管理营地、预订和注册儿童。


✨ 特性

  • 🔍 按类别、容量或位置搜索营地
  • 🏕️ 创建、更新和删除营地记录
  • 📅 以Knack兼容格式处理日期和时间范围
  • 👶 列出每个营地的注册儿童
  • ➕ 将孩子添加到家长配置文件
  • 📦 检索预订和可用性
  • 🔐 通过环境变量安全访问API
  • 🤖 完全兼容MCP,用于AI工具集成

🏗️ 架构概述

  • 框架: FastMCP
  • 后端API: Knack REST API
  • 语言: Python 3.9+

🧠 MCP工具可用

🔍 search_camps

使用可选过滤器搜索冬令营。

参数

  • category (艺术、体育、STEM、自然)
  • min_capacity
  • location

🏕️ get_camp

按名称获取详细的营地信息。

参数

  • camp_name

➕ create_camp

创建一个新的冬令营。

必需参数

  • name
  • category
  • start_date, end_date (年-月-日)
  • start_time, end_time (时:分上午/下午)
  • capacity
  • location_street, location_city, location_state, location_zip
  • provider_id
  • description

✏️ update_camp

更新现有营地。

参数

  • camp_id
  • name (可选)
  • category (可选)
  • capacity (可选)
  • description (可选)

🗑️ delete_camp

按营地ID删除营地。

参数

  • camp_id

👶 list_child

列出特定营地的注册儿童。

参数

  • camp_name

➕👧 add_child

在父配置文件下添加子项。

参数

  • parent
  • child_name
  • child_age
  • child_date_of_birth (可选)
  • diet_res (可选)
  • emergency_contact (可选)

📦 get_bookings

检索营地的所有预订。

参数

  • camp_id

📊 get_camp_availability

查看营地的可用位置。

参数

  • camp_id

🧩 日期处理

服务器使用以下命令自动将人类可读的日期和时间转换为Knack所需的格式:

format_date_range()

这确保了所有营地时间表的一致性。


🛠️ 未来的增强功能

  • 父级和提供者创建工具
  • 预订创建和取消
  • 付款状态同步
  • 营地分析和报告
  • 基于角色的访问控制

📜 许可证

MIT许可证——免费使用、修改和分发。


这是为2025年的Contra假日挑战赛所做的