Bus MCP

QuickBus MCP服务器

此存储库包含两个模型上下文协议（MCP）服务器，设计用于与QuickBus后端API接口。这些服务器使LLM驱动的应用程序能够通过标准化的工具界面执行管理任务和用户预订操作。

概述

该项目分为两个专用MCP服务器：

1. DD QuickBus管理MCP：提供用于管理公共汽车、路线、行程、员工和联系请求的管理工具。
2. DD QuickBus用户MCP：提供面向客户的功能，包括巴士搜索、座位可用性检查、订票和历史管理。

技术栈

• 语言：Python 3.10+
• 框架: FastMCP
• 依赖管理: 紫外线
• 沟通：请求（HTTP/JSON API）
• 验证：双关语和验证器

项目结构

Bus-Mcp/
├── DD-QuickBus-Admin-MCP/     # Administrative Tools
│   ├── main.py                # Server entry point
│   ├── tools/                 # Tool implementations
│   └── schemas/               # Pydantic data models
└── DD-QuickBus-User-MCP/      # Customer Booking Tools
    ├── main.py                # Server entry point
    └── tools/                 # Tool implementations

安装与设置

先决条件

• Python 3.10或更高版本。
• 紫外线 包管理器（建议用于无缝依赖处理）。

1.环境配置

通过创建 .env 每个服务器目录中的文件。

DD-QuickBus-Admin-MCP/.env 和 DD-QuickBus-User-MCP/.env:

BASE_URL=https://your-api-url.com

2.依赖安装

导航到每个目录并同步环境：

# Admin MCP Setup
cd DD-QuickBus-Admin-MCP
uv sync

# User MCP Setup
cd ../DD-QuickBus-User-MCP
uv sync

______________________________________________________________________

测试和检验

FastMCP Inspector是一款功能强大的工具，用于在与LLM集成之前，在基于web的界面中测试工具定义并验证API响应。

运行检查器

要为任一服务器启动检查器，请在相应目录中使用以下命令：

# Launch Admin Inspector
cd DD-QuickBus-Admin-MCP
uv run fastmcp dev inspector main.py

# Launch User Inspector
cd DD-QuickBus-User-MCP
uv run fastmcp dev inspector main.py

检查员将提供一个本地URL（通常 http://localhost:3000)在那里，您可以手动触发工具并检查JSON有效载荷。

______________________________________________________________________

LLM客户端配置

要在MCP兼容的LLM客户端（如Claude Desktop）中使用这些服务器，请将以下配置添加到客户端的设置文件中。

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "quickbus-admin": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Bus-Mcp/DD-QuickBus-Admin-MCP",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "BASE_URL": "https://your-api-url.com"
      }
    },
    "quickbus-user": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Bus-Mcp/DD-QuickBus-User-MCP",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "BASE_URL": "https://your-api-url.com"
      }
    }
  }
}

*注：更换 /absolute/path/to/ 使用系统上的实际路径。*

______________________________________________________________________

工具摘要

管理工具（DD Admin MCP）

• 认证: login
• 公交车管理: get_all_buses, add_bus, update_bus, delete_bus
• 路线管理: get_all_routes, add_route
• 行程管理: get_all_trips, add_trip, update_trip, delete_trips
• 系统管理: get_employees, get_contact_requests

客户工具（DD预订MCP）

• 搜索和发现: search_bus, get_available_seats
• 预订生命周期: create_ticket, cancle_ticket
• 身份验证（OTP）: auth, validate
• 账户管理: get_tickets, get_ticket_details