沙滩网球场地查询服务

一个简化的MCP服务器,用于查询Villa Park Beach Sports的沙滩网球场地可用性和价格。

  • by fsaito-github
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 fsaito-github/bt-mcp

使用说明

<<<<<<<头

🏐 沙滩网球MCP服务器

简化的MCP服务器,用于查询Villa Park Beach Sports海滩网球场的可用性。

🚀 特点

  • ✅ 100%真实数据 - 只有时间和抓取的网站框架
  • ✅ 实际价格 直接从HTML中提取价格
  • ✅ 无模拟数据 删除所有模拟数据
  • ✅ 自动爬行 - 使用Crawl4AI实时数据
  • ✅ 按时间过滤器 - 按时区查询
  • ✅ 有针对性的代码 459行高效代码
  • ✅ 基本依赖关系 需要4个包

📁 项目结构

vila/
├── mcp_server/
│   ├── beach_tennis_mcp.py    # Servidor MCP principal (459 linhas)
│   ├── requirements.txt       # Dependências (4 pacotes)
│   └── config.env.example     # Configuração
├── test_mcp.py               # Script de teste
├── CHANGELOG.md              # Log de mudanças
└── README.md                 # Este arquivo

🛠️ 安装

# Instalar dependências
cd mcp_server
pip install -r requirements.txt

# Configurar variáveis (opcional)
cp config.env.example .env
# Edite o arquivo .env conforme necessário

🧪 测试

# Testar o MCP server
python test_mcp.py

# Testar configuração (opcional)
python test_config.py

🎯 使用

基本查询

from mcp_server.beach_tennis_mcp import BeachTennisMCP

mcp = BeachTennisMCP()
result = await mcp.get_court_availability("2025-10-22")

查询过滤器

# Horários após 17:00
result = await mcp.get_court_availability("2025-10-22", time_after="17:00")

📊 结果

  • 🏟️ Quadras: 8个方块(方块01-08)
  • ⏰ 时间 : 仅在网站上可用(例如:12小时)
  • 💰 价格: 直接从HTML中提取(例如:R$ 125.00)
  • 🕐 覆盖范围 : 抓取网站的实际时间

🔧 配置

服务器可以通过文件中的环境变量进行配置 .env:

# Configurações de Horários
START_HOUR=7          # Horário de início (padrão: 7)
END_HOUR=22           # Horário de fim (padrão: 22)

# Configurações de Preços
BASE_PRICE_DAY=80.0   # Preço diurno (padrão: 80.0)
BASE_PRICE_NIGHT=104.0 # Preço noturno (padrão: 104.0)
NIGHT_START_HOUR=18   # Início do preço noturno (padrão: 18)

# Configurações da Academia
TOTAL_COURTS=8        # Número de quadras (padrão: 8)
ACADEMY_URL=https://letzplay.me/villa-parkbeach/location

🎉 状态

✅ 功能齐全的系统
✅ 简化和优化的代码
✅ 通过环境变量灵活配置
✅ 没有结果限制
✅ 准备生产

bt mcp

8569c18cd0eff5dd8b02f5b66c7b23ccbd17cd5