Claimplane MCP

EasyAirClaim MCP服务器

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/