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

MCP Travel Desk — 一个精简的 MCP 客户端和服务端演示

这是一个简单的代码仓库，展示如何构建 MCP 服务，以及如何将 Claude Desktop 用作客户端。这里演示了一个简单的 Travel Desk 系统，用于处理员工差旅申请、审批和历史记录追踪——所有操作都可以直接通过 Claude 完成。你可以修改此代码仓库的内容，开发特定的 MCP 用例。

---

设置说明

1. 安装 Claude Desktop

从 Anthropic 下载并安装 Claude Desktop。它将作为你的 MCP 客户端。

---

2. 安装 MCP Python SDK

pip install mcp

3. 安装 uv（Python 包管理器）

pip install uv

在 macOS 上，如果此操作失败：

brew install uv

4. 初始化 MCP 服务

uv init

5. 创建 main.py

将 main.py 代码添加到代码仓库中

6. 将服务安装到 Claude

uv run mcp install main.py

此操作将：

创建一个虚拟环境（.venv） 将你的服务添加到 Claude 配置中 输出如下日志：

Added server 'TravelDesk' to Claude config
Successfully installed TravelDesk in Claude app

7. macOS 故障排查

如果服务未能在 Claude 中启动： 运行：

brew install uv

重新启动 Claude Desktop 前往 Claude → Developer Settings，确保服务状态为 Running

8. 将 Claude 用作 MCP 客户端

Claude 会从 .mcp/claude.json 读取 MCP 配置。

9. 工具会显示在 Claude 界面中

安装后，以下工具将在 Claude 中可用：

submit_travel_request get_travel_history approved_trips_count greeting://{name}

10. 通过 Claude 提问

试着询问： 为 E001 提交一份从 2025-01-01 到 2025-01-05、前往 Paris 的差旅申请 E002 有多少次已批准的差旅？ 获取 E001 的差旅历史 greeting://Chaitanya