航班索赔测试服务器

专为EasyAirClaim开发的测试服务器,提供数据库查询、测试数据生成和索赔管理等功能。

  • by davidvv
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 davidvv/claimplane-mcp

使用说明

EasyAirClaim MCP服务器

现场: https://claimplane.com --航班赔偿平台帮助乘客在欧盟261项下索赔高达600欧元。

EasyAirClaim开发和测试的模型上下文协议(MCP)服务器。

⚠️ 仅限开发

此服务器仅用于开发和测试!

  • 无需身份验证即可完全访问数据库
  • 切勿与生产数据一起使用
  • 仅连接到开发/测试数据库

特征

  • 🔍 查询数据:检查客户、索赔、文件是否存在
  • ✨ 创建测试数据:快速生成逼真的测试场景
  • 🔄 管理索赔:更新状态、添加注释、跟踪工作流
  • 🛠️ 开发实用程序:种子数据、重置数据库、验证完整性

快速开始

1.启动服务器

cd /home/david/easyairclaim-mcp
cp .env.example .env
docker-compose up -d

2.配置克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "easyairclaim-dev": {
      "command": "curl",
      "args": ["-N", "-H", "Accept: text/event-stream", "http://localhost:39128/sse"]
    }
  }
}

重新启动克劳德桌面。

3.测试连接

在克劳德桌面中:

Check the EasyAirClaim MCP server health

可用工具(18)

健康与系统

  • health_check -服务器和数据库连接
  • get_database_stats -实体计数和统计
  • get_environment_info -配置详细信息

客户管理

  • create_customer -创建新客户
  • get_customer -通过ID获取客户
  • get_customer_by_email -通过电子邮件查找
  • list_customers -分页列表
  • delete_customer -删除客户

索赔管理

  • create_claim -使用EU261计算创建索赔
  • get_claim -获取索赔详细信息
  • list_claims -带过滤器的列表
  • transition_claim_status -更新状态
  • add_claim_note -添加管理员备注

开发公用事业

  • seed_realistic_data -生成测试数据
  • create_test_scenario -创建客户+索赔
  • reset_database -清除测试数据(⚠️ 破坏性)
  • validate_data_integrity -检查问题

示例用法

# Check if customer exists
Is customer test@example.com in the database?

# Create test data
Create a customer and a delayed Lufthansa flight claim

# List claims
Show me all claims in 'under_review' status

# Update claim
Move claim CLM-12345 to approved status

# Seed data
Create 10 realistic test claims

# Get overview
Show me database statistics

建筑学

  • 快速API 支持MCP协议的SSE
  • 直接SQLAlchemy 连接易线航空索赔数据库
  • 进口 主要应用程序模型/服务(只读)
  • 码头工人 带有健康检查的容器

项目结构

easyairclaim-mcp/
├── server.py              # MCP server with SSE endpoint
├── config.py              # Configuration management
├── database.py            # Async database connection
├── tools/                 # MCP tool implementations
│   ├── health_tools.py    # System tools
│   ├── customer_tools.py  # Customer management
│   ├── claim_tools.py     # Claim management
│   └── dev_tools.py       # Development utilities
├── docker-compose.yml     # Container configuration
├── Dockerfile             # Container image
├── requirements.txt       # Python dependencies
└── MCP_USAGE_GUIDE.md     # Comprehensive guide

配置

编辑 .env 文件:

ENVIRONMENT=development
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/flight_claim
MCP_PORT=39128
ENABLE_DESTRUCTIVE_OPS=true

端口

  • 39128 -MCP SSE端点
  • 8083 -状态仪表板(可选)

安全功能

  • 环境验证(块生产)
  • 破坏性操作防护装置
  • 只读主应用程序代码挂载
  • 健康检查监测

故障排除

服务器无响应

docker logs easyairclaim-mcp-server
docker-compose restart

数据库连接问题

检查主应用程序数据库是否正在运行:

docker ps | grep postgres

Claude中的工具错误

  • 验证参数类型
  • 检查ID的UUID格式
  • 使用YYYY-MM-DD日期格式
  • 使用大写的IATA机场代码

文档

看 MCP_USAGE_GUIDE.md 用于:

  • 详细的工具文档
  • 使用示例
  • 开发工作流程
  • 故障排除指南

发展

在本地运行(不使用Docker)

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server.py

查看日志

docker-compose logs -f

停止服务器

docker-compose down

安全说明

此MCP服务器具有:

  • ❌ 无身份验证
  • ❌ 无授权
  • ❌ 无速率限制
  • ✅ 完全数据库访问

切勿连接到生产数据库或使用真实的客户数据!


版本: 1.0.0
创建: 2026-01-14
位置: /home/david/easyairclaim-mcp/