使用说明

项目简介

Togtider 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它作为一个工具集成到 Claude Desktop 等 MCP 客户端中，提供挪威 Jåttåvågen 车站的实时火车出发信息。用户可以通过 Claude 向 Togtider 服务器发送请求，查询最新的列车时刻表和列车延误情况。

主要功能点

实时列车信息: 从 Bane NOR API 获取最新的火车出发数据。
方向分组: 将出发信息按南北方向分组显示。
延误识别: 识别并标记延误的列车。
MCP 集成: 无缝集成到 Claude Desktop 等 MCP 客户端。

安装步骤

克隆仓库:

git clone https://github.com/uvaaland/togtider.git
cd togtider

创建虚拟环境 (推荐):

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate  # Windows

安装依赖:

pip install -r requirements.txt

服务器配置

要将 Togtider 集成到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，并添加 Togtider 的 MCP 服务器配置。

配置文件位置:

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

配置内容 (JSON 格式):

在 'mcpServers' 字段下添加 'togtider' 配置项。请根据您的操作系统选择合适的配置，并替换 '/path/to/your/togtider/directory' (macOS/Linux) 或 'C:\path\to\your\togtider\directory' (Windows) 为您本地仓库的实际路径。

macOS 配置示例:

"mcpServers": {
  "togtider": {
    "command": "python",
    "args": [
      "-m",
      "mcp_tool",
      "/path/to/your/togtider/directory"
    ]
  }
}

Windows 配置示例:

"mcpServers": {
  "togtider": {
    "command": "python",
    "args": [
      "-m",
      "mcp_tool",
      "C:\\path\\to\\your\\togtider\\directory"
    ]
  }
}

配置参数说明:

'command': 启动 MCP 服务器的命令，这里使用 'python' 解释器。
'args': 传递给 'command' 的参数列表:
- '-m mcp_tool': 以模块方式运行 'mcp_tool.py' 文件，作为 MCP 工具入口。
- '/path/to/your/togtider/directory' 或 'C:\path\to\your\togtider\directory': Togtider 仓库在您本地文件系统中的绝对路径。

基本使用方法

配置完成后，您可以在 Claude Desktop 中通过自然语言指令来查询 Jåttåvågen 车站的火车出发信息。例如：

"Show me the upcoming train departures from Jåttåvågen station" (显示 Jåttåvågen 车站即将出发的列车)
"Are there any delayed trains at Jåttåvågen?" (Jåttåvågen 有延误的列车吗？)
"When is the next train to Stavanger from Jåttåvågen?" (从 Jåttåvågen 到 Stavanger 的下一班火车是什么时候？)

Claude 将调用 Togtider 工具并返回实时的列车出发信息。

关键词