最近Citi Bike站点查找工具

一个基于TypeScript的MCP服务器工具,用于查找最近的Citi Bike站点,并提供距离、电动自行车和经典自行车的可用性信息。

  • by sjhangiani12
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sjhangiani12/citibike_mcp

使用说明

概述

  • 目的:Smithery兼容的TypeScript MCP服务器提供了一个工具,可以根据距离和ebike/classic可用性找到最近的花旗自行车站。
  • 数据:花旗自行车GBFS馈送: station_status.json 和 station_information.json.

快速入门(Smithery)

  • Prereq:Node.js18+和一个Smithery帐户/API密钥。
  • 开发人员(需要Smithery CLI): npm run dev (港口通往史密斯利游乐场)
  • 部署:推送到GitHub,然后使用https://smithery.ai/new部署仓库。

本地建设

  • 安装deps: npm install
  • 构建: npm run build

入口点

  • 史密斯利荷载 src/index.ts 导出默认值 createServer 函数返回MCP服务器实例。

工具

  • nearest_citibikes:返回最近的车站,包括距离和可用性。
    • 输入: { lat: number, lon: number, limit?: number }
    • 输出:JSON stations[] 包括:
      • name, station_id, lat, lon, distance_m
      • available_ebikes, available_classic_bikes, available_total_bikes
      • available_docks, capacity_total_docks, is_renting, is_returning, last_reported

备注

  • available_classic_bikes 用途 num_bikes_available_types.mechanical 当存在时;否则派生为 num_bikes_available - num_ebikes_available.
  • 结果按距离排序。 limit 默认值为5(允许1-50)。