AI导哈

客户旅行数据协议服务器

一个提供客户数据、旅行历史和请求管理的MCP服务器，适用于旅行公司的客户服务场景。

  • by stefanjwojcik
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 stefanjwojcik/mcpdemo

使用说明

旅行社MCP服务器

一个MCP（模型上下文协议）服务器，为Claude提供访问某旅行公司客户数据、旅行历史以及信息请求的权限。

特点

  • 客户管理搜索并检索客户资料
  • 旅行历史按客户或目的地查询过去的和即将进行的行程
  • 请求跟踪管理客户咨询及后续跟进请求

要求

  • Python 3.10 或更高版本
  • pip 包管理器

安装

  1. 克隆或下载此仓库

  2. （可选）创建一个虚拟环境：

    python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

  3. 安装依赖项：

    pip install -r requirements.txt

  4. 初始化数据库：

    python -m src.seed_data

运行服务器

MCP服务器设计为通过stdio传输由Claude Desktop运行：

python -m src.server

Claude桌面版的配置

将此添加到您的Claude Desktop MCP配置中：

macOS（苹果电脑操作系统）: ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "travel-company": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/mcpdemo"
    }
  }
}

可用工具

客户工具

  • search_customers按姓名、电子邮件、电话或ID搜索客户
  • get_customer_profile获取包含行程统计的详细客户资料

旅行工具

  • search_trips按目的地、日期范围或状态搜索行程
  • get_trip_history获取特定客户的行程历史

请求工具

  • search_requests按各种标准搜索信息请求
  • get_pending_requests获取待跟进的客户请求

示例查询

试试问问克劳德：

  • “显示所有名为约翰的客户”
  • “客户ID为5的客户都乘坐过哪些行程？”
  • “列出过去7天内所有待处理的请求”
  • “查找2024年前往巴黎的旅行”
  • “给我看一下 customer@email.com 这个客户的资料”

项目结构

mcpdemo/
├── src/
│   ├── server.py           # Main MCP server
│   ├── database.py         # Database layer
│   ├── seed_data.py        # Demo data generator
│   └── tools/              # Tool implementations
├── data/                   # SQLite database
├── config/                 # Configuration files
└── logs/                   # Server logs

发展

服务器使用SQLite进行数据存储，演示数据包括：

  • 100多个客户记录
  • 200多条旅行记录
  • 50多次信息请求

所有数据均为合成数据，仅用于演示目的。

许可证

麻省理工学院（MIT）

相关 MCP