使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个完整的 MCP 服务器，使用 Rust 语言与 rmcp 库，提供资源管理、工具执行和提示模板渲染能力。服务器通过标准输入/输出（stdin/stdout）与 MCP 客户端通信，支持资源读取、工具调用、提示渲染等核心 MCP 功能。

• 主要功能点

  • 资源（Resources）：管理与提供会话相关的上下文、位置、目的地等上下文信息，以及实时/模板化资源（如周边 Departures）。
  • 工具（Tools）：实现一组用于对话交互、路线规划、实时查询等的工具。包括获取、设置和重置用户上下文，站点查询、路线查询、实时 Departures 监控等。
  • 提示（Prompts）：定义并渲染多种 MCP 提示，面向旅行导航、 Departures 监控、旅途跟踪等场景。
  • MCP 服务器信息与能力：明确声明支持工具、提示、资源等能力，并提供服务器实现细节（包括上下文管理与工作流）。
  • 多种传输场景：当前实现通过 stdin/stdout 与客户端进行通信，便于与 MCP Inspector、Claude Desktop 等工具对接。

• 安装步骤

  • 安装 Rust（2021 及以上版本）。
  • 从源码构建：git clone <仓库地址>，进入目录后执行 cargo build --release。
  • 运行时以 MCP 服务器形式启动，默认通过 stdio 与客户端通信。开发者可使用 MCP Inspector、Claude Desktop 等进行测试与调试。

• 服务器配置（用于 MCP 客户端与服务器连接的配置信息，JSON 格式，包含 server name、command、args 等）

  • 由于 MCP 客户端需要知道要启动的服务器进程及其启动命令，示例配置如下（请将以下字段中的路径替换为实际环境中的可执行文件路径）： { "server_name": "dvb-mcp", "command": "/path/to/dvb-mcp", "args": [] } 说明：
  • server_name：在 MCP 客户端配置中用于标识该 MCP 服务器的名称。
  • command：要启动的 MCP 服务器可执行文件路径。该仓库实现的服务器可通过构建生成的可执行文件来启动。
  • args：启动参数，当前实现通过标准输入/输出进行通信，通常不需要额外参数，若需要，可在此处添加。
  • 客户端启动流程简述：客户端需要启动上述 command 指定的进程，并通过标准输入输出建立通信通道，发送 JSON-RPC 请求，接收服务器响应。

• 基本使用方法

  • 启动与连接：在正确配置后，使用 MCP 客户端（如 MCP Inspector、Claude Desktop）启动服务器进程并建立连接。连接后即可通过工具、资源和提示进行对话。
  • 常用操作示例（按组件组合使用，具体请求对接请参考 MCP 客户端的规范与文档）：
    • 读取会话上下文资源 dvb://user/context，获取当前已保存的 origin/location/destination 等信息。
    • 调用 find_stations/find_nearby_stations 等工具，协助定位站点并进行路线规划。
    • 使用 navigation-assistant、departure-monitor 等提示模板来引导对话与信息获取。
    • 通过 read_resource、list_resources 等接口管理与查看资源集合。
  • 安全与会话：当前实现包含会话范围内的上下文（origin、location、destination），会话结束前会保持状态，提供持续的对话上下文。