项目简介

DNDzgz MCP服务器是基于Model Context Protocol (MCP) 开发的应用后端,旨在连接萨拉戈萨的公共交通(有轨电车、公交车)和共享单车(Bizi)数据源,并通过标准化的工具接口提供实时信息和位置相关的功能给支持MCP协议的LLM(大型语言模型)客户端。

主要功能点

  • 实时到站查询: 获取指定有轨电车或公交车站的实时到站时间估算。
  • 站点信息查询: 获取萨拉戈萨所有有轨电车、公交车站或共享单车站点列表,并可根据用户当前位置排序,查找附近的站点。
  • 共享单车可用性: 查询指定共享单车站点的自行车数量和可用停车位。
  • 地址地理编码: 根据给定的地址(限定萨拉戈萨区域),获取其地理坐标(经度和纬度)。
  • Google地图链接生成: 根据地理坐标生成对应的Google地图链接,方便用户查看位置。

安装步骤

  1. 克隆仓库: 打开终端或命令行,运行以下命令将项目代码下载到本地。
    git clone https://github.com/danilat/mcp-dndzgz.git
  2. 进入目录: 进入刚刚克隆下来的项目文件夹。
    cd mcp-dndzgz
  3. 安装依赖: 运行以下命令安装项目所需的依赖包。
    npm install

服务器配置(供MCP客户端使用)

该服务器通过Stdio传输协议与MCP客户端通信。在支持MCP协议的LLM客户端中,你需要配置如何启动并连接到此服务器。典型的配置包括:

  • 服务器名称 (server name): 为此服务器定义一个名称,例如 'dndzgz'。
  • 启动命令 (command): 启动服务器的可执行文件,通常是 'node'。
  • 参数 (args): 传递给启动命令的参数,指向服务器的主文件路径。例如,如果你的项目路径是 '/home/user/mcp-dndzgz',则参数应包含 '/home/user/mcp-dndzgz/index.js'。
  • 环境变量 (env): 必须设置一个名为 'GOOGLE_MAPS_API_KEY' 的环境变量,其值是有效的Google Maps API Key,用于地址地理编码功能。

示例配置片段说明 (不是实际的代码,只是说明结构):

{
    "mcpServers": {
        "自定义服务器名称": {
            "command": "node",
            "args": ["/你的项目实际路径/index.js"], // 替换为 mcp-dndzgz 项目下的 index.js 文件路径
            "env": {
                "GOOGLE_MAPS_API_KEY": "你的Google Maps API Key" // 替换为你的 API Key
            }
        }
    }
}

重要提示: 请根据你的操作系统和实际项目存放路径修改 'args' 中的文件路径,并将 'GOOGLE_MAPS_API_KEY' 替换为你自己的有效密钥。

基本使用方法

在你的LLM客户端中完成上述配置后,启动客户端。客户端会自动启动并连接配置好的DNDzgz MCP服务器。然后,LLM即可识别并使用该服务器提供的各种工具(如 'zaragoza-tram-estimations', 'zaragoza-bus-stops', 'geolocation-from-address' 等),获取萨拉戈萨相关的实时交通和位置信息,从而增强LLM处理相关查询的能力。

信息

分类

网页与API