🧳 MCP Travel Desk — A Minimal MCP Client & Server Demo

🧳 MCP Travel Desk — A Minimal MCP Client & Server Demo

site icon
2025.05.05 0
Python旅行管理系统MCP演示交流协作
MCP Travel Desk 是一个简单的 MCP 客户端和服务器演示项目,展示了如何构建一个 MCP 服务器并使用 Claude Desktop 作为客户端。该系统主要用于处理员工旅行请求、审批和历史记录跟踪,所有功能都可以直接从 Claude 访问。
View on GitHub

Overview

基本能力

产品定位

MCP Travel Desk 是一个用于员工旅行管理的演示系统,展示了 MCP 服务器和客户端的交互方式。

核心功能

  • 提交旅行请求
  • 获取旅行历史记录
  • 统计已批准的旅行次数
  • 发送问候消息

适用场景

  • 企业内部旅行管理系统
  • MCP 技术演示和学习

工具列表

  • submit_travel_request: 提交旅行请求
  • get_travel_history: 获取旅行历史记录
  • approved_trips_count: 统计已批准的旅行次数
  • greeting://{name}: 发送个性化问候

常见问题解答

  • 如果服务器没有在 Claude 中启动,可以尝试运行 brew install uv 并重启 Claude Desktop
  • 确保在 Claude 的开发者设置中服务器状态为运行中

使用教程

使用依赖

  1. 安装 Claude Desktop: 从 Anthropic 下载并安装
  2. 安装 MCP Python SDK:
pip install mcp
  1. 安装 uv (Python 包管理器):
pip install uv

在 macOS 上如果失败:

brew install uv

安装教程

  1. 初始化 MCP 服务器:
uv init
  1. 创建 main.py 并添加代码
  2. 将服务器安装到 Claude:
uv run mcp install main.py

调试方式

  1. 在 Claude 中尝试以下查询:
Submit a travel request for E001 to Paris from 2025-01-01 to 2025-01-05
How many approved trips does E002 have?
Get travel history for E001
greeting://Chaitanya
  1. 检查 Claude 的开发者设置确保服务器正在运行

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。