PassioGo_MCP_Server

PassioGo_MCP_Server

用于与 PassioGO 系统中的实时交通数据交互的智能后端服务。基于 FastMCP 构建。

---

作者／联系信息

姓名：Jozef Dusenka 电子邮件：[email protected]

许可证

本项目采用 Apache-2.0 许可证授权，详情请参阅 LICENSE 文件。

前提条件

• Python
• uv 包管理器（'pip install uv'）

部署说明

以下两个示例均使用 Claude Desktop 运行 MCP 服务。

示例 1：本地 MCP 服务设置

在 Claude Desktop 上运行的说明

• 此 MCP 服务也可在其他 MCP 客户端上运行；不过，运行说明可能略有不同。
• 下载 Claude Desktop（（https://claude.ai/download））
• 下载此代码库。
• 打开 Claude Dektop -> 文件 -> 设置 -> 开发者 -> 编辑配置
• 打开 claude_desktop_config.json 文件
• 如果文件为空，请替换为：

{
    "mcpServers": {
        "passioGo": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\Path to the \\PassioGo_MCP_Server",
                "run",
                "main.py"
            ]
        }
    }
}

• 保存更改并重启 Claude Desktop
• 此时，Claude Desktop 应已包含可用的 Passio Go MCP 服务工具，但会显示一个小锤子图标
• MCP 客户端随后会自动判断回答问题时是否需要使用任何工具

示例 2：远程 MCP 服务设置

免费版用户须知：Claude Desktop 免费版原生不支持远程 MCP 服务。不过，您可以使用下方所示的 mcp-remote 变通方案连接到远程服务。

在 Claude Desktop 上运行的说明

• 此 MCP 服务也可在其他 MCP 客户端上运行；不过，运行说明可能略有不同。
• 下载 Claude Desktop（（https://claude.ai/download））
• 下载此代码库。
• 切换到 remote_mcp_server 分支
• 使用命令 'uv run main.py' 将服务部署到首选主机；该命令应会启动 Uvicorn ASGI 应用，并监听默认端口 3152
• 确保服务可通过公共 URL 访问（例如 https://your-server-address.com）
• 打开 Claude Desktop -> 文件 -> 设置 -> 开发者 -> 编辑配置
• 打开 claude_desktop_config.json 文件
• 如果文件为空，请替换为：

{
    "mcpServers": {
        "passioGo": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://your-server-address:3152/sse"
            ]
        }
    }
}

• 保存更改并重启 Claude Desktop
• 此时，Claude Desktop 应已包含可用的 Passio Go MCP 服务工具，但会显示一个小锤子图标
• MCP 客户端随后会自动判断回答问题时是否需要使用任何工具

示例

用户：

我在阿肯色大学的联合车站。接下来 5 分钟内有哪些公交车会停靠这里？

---

Claude Desktop：

我来帮你查一下接下来几分钟内有哪些公交车会停靠阿肯色大学的联合车站。让我先查看交通系统信息。

现在，我来查看即将抵达联合车站的在运行车辆：

现在，我来查看交通系统是否有任何警报：

根据我收集到的信息，以下公交车应该会在接下来 5 分钟内抵达联合车站：

26 Peak 路线（红色公交车 #27）——目前就在联合车站站点或附近 21 Peak 路线（蓝色公交车 #43）——目前在联合车站附近 48 Peak 路线（粉色公交车 #32）——目前在联合车站附近

请注意，目前有一条警报称 Passio 实时地图今天出现了一些问题，这可能会影响实时到站预测的准确性。阿肯色大学的交通系统名为 Razorback Transit。 根据坐标，#27、#43 和 #32 似乎就在联合车站附近或已经到达，因此它们是接下来 5 分钟内最合适的选择。如果你要前往特定目的地，请告诉我，我可以帮你判断哪条路线最适合你。

---

用户：

我想往北去校园的农业区域。可以乘坐哪些公交车？

---

Claude Desktop

我来帮你查找从 Union Station 向北前往校园农业区的公交线路。 我先查看从 Union Station 出发、开往阿肯色大学校园北部农业区的线路。

根据我收集到的信息，以下是从 Union Station 前往阿肯色大学校园农业区（位于校园北部）的最佳选择： 最佳选择：Route 21 Peak（蓝色公交） 这条线路可直达农业区，停靠站包括：

Food Science（校园北部） Crafton Place（农业区） Garland & Sycamore Fair Park

Route 21 Peak 公交车（#43）目前正开往 Union Station，是前往校园农业区的绝佳选择。 备选方案：Route 26 Peak（红色公交） 这条线路也从 Union Station 向北行驶，停靠站包括：

Plant Science South Creekside 并继续向北前往多个地点

Route 26 Peak 公交车（#27）目前在 Union Station 附近。 其他选择：Route 33 Peak（橙色公交） 虽然这条线路向北行驶，但方向更偏西北，并非直接前往农业区。它可能不是前往校园农业区最直接的线路。 我建议乘坐 Route 21 Peak（蓝色）公交车，因为它似乎最直接服务于农业区，停靠校园北部的 Food Science 和其他农业相关地点。