项目简介
DNDzgz MCP服务器是基于Model Context Protocol (MCP) 开发的应用后端,旨在连接萨拉戈萨的公共交通(有轨电车、公交车)和共享单车(Bizi)数据源,并通过标准化的工具接口提供实时信息和位置相关的功能给支持MCP协议的LLM(大型语言模型)客户端。
主要功能点
- 实时到站查询: 获取指定有轨电车或公交车站的实时到站时间估算。
- 站点信息查询: 获取萨拉戈萨所有有轨电车、公交车站或共享单车站点列表,并可根据用户当前位置排序,查找附近的站点。
- 共享单车可用性: 查询指定共享单车站点的自行车数量和可用停车位。
- 地址地理编码: 根据给定的地址(限定萨拉戈萨区域),获取其地理坐标(经度和纬度)。
- Google地图链接生成: 根据地理坐标生成对应的Google地图链接,方便用户查看位置。
安装步骤
- 克隆仓库: 打开终端或命令行,运行以下命令将项目代码下载到本地。
git clone https://github.com/danilat/mcp-dndzgz.git - 进入目录: 进入刚刚克隆下来的项目文件夹。
cd mcp-dndzgz - 安装依赖: 运行以下命令安装项目所需的依赖包。
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