BART (San Francisco Transit) MCP 服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 LLM 应用提供访问天气信息和旧金山湾区捷运 (BART) 实时到站信息的能力。通过此 MCP 服务器，LLM 可以查询特定州的天气警报、指定经纬度的天气预报，以及特定 BART 车站的实时列车到站信息。

主要功能点

获取天气警报 (get-alerts): 查询指定美国州份的实时天气警报信息。
获取 BART 到站信息 (get-bart-departures): 查询指定 BART 车站的实时列车到站信息。
获取天气预报 (get-forecast): 查询指定经纬度的天气预报信息。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js 和 npm。

克隆仓库: 将仓库克隆到本地：

git clone https://github.com/tchbw/bart-mcp.git
cd bart-mcp

安装依赖: 在项目根目录下运行：
```
npm install
```

服务器配置

MCP 客户端需要以下配置信息来连接到此服务器。请将以下 JSON 配置添加到你的 MCP 客户端配置中：

{
  "serverName": "weather",
  "command": "node",
  "args": ["src/index.ts"]
}

配置参数说明:

'serverName': 服务器名称，设置为 "weather"。
'command': 启动服务器的命令，这里使用 'node' 运行 TypeScript 代码。
'args': 命令参数，指定服务器入口文件为 'src/index.ts'。

基本使用方法

启动服务器: 在项目根目录下运行以下命令启动 MCP 服务器：
```
npm start
```
或者直接运行：
```
node src/index.ts
```
服务器将通过标准输入/输出 (stdio) 与 MCP 客户端通信。

在 MCP 客户端中调用工具: 在你的 MCP 客户端中，你可以使用以下工具名称和参数来调用服务器的功能：

get-alerts: 获取天气警报

{
  "tool_call": {
    "name": "get-alerts",
    "arguments": { "state": "CA" }  // 例如，查询加州的天气警报
  }
}

get-bart-departures: 获取 BART 到站信息

{
  "tool_call": {
    "name": "get-bart-departures",
    "arguments": { "stationCode": "MONT" } // 例如，查询 Montgomery St. 车站的到站信息
  }
}

get-forecast: 获取天气预报

{
  "tool_call": {
    "name": "get-forecast",
    "arguments": { "latitude": 37.7749, "longitude": -122.4194 } // 例如，查询旧金山的天气预报
  }
}

请参考 MCP 客户端的文档，了解如何在你的客户端中配置和调用 MCP 服务器及工具。

关键词