Jp Transit Search

日本交通搜索

一款日本公交路线规划工具，具有CLI界面和用于AI助手的MCP服务器。搜索车站之间的列车路线，获取出发时间，并管理车站数据。

🚀 在行动中看到它

主要城市路线

大阪至东京（新干线）

$ uv run jp-transit search "大阪" "東京"

Route 1: 大阪 → 東京
Duration: 15:55発→18:45着 2時間50分（乗車2時間34分）
Cost: 14,720円（乗車券8,910円　特別料金5,810円）
Transfers: 1

Transfer Details:
┌─ 大阪 → 新大阪 (JR京都線)
│  15:55→15:59 [4分] Platform: 7番線→6番線
├─ 新大阪 → 東京 (JR新幹線)
│  16:15→18:45 [2時間30分] Platform: 26番線→17番線
│  Via: 京都(16:30) → 名古屋(17:06) → 新横浜(18:27) → 品川(18:39)
└─ Total: 2時間50分, ¥14,720

东京至京都（直达新干线）

$ uv run jp-transit search "東京" "京都"

Route 1: 東京 → 京都
Duration: 15:48発→18:00着 2時間12分（乗車2時間12分）
Cost: 14,170円（乗車券8,360円　特別料金5,810円）
Transfers: 0

Direct Route:
└─ 東京 → 京都 (JR新幹線)
   15:48→18:00 [2時間12分] Platform: 18番線→13番線
   Total: 2時間12分, ¥14,170

特定时间的早晨通勤

$ uv run jp-transit search "新宿" "東京" --datetime "2025-11-07 08:30"

Route 1: 新宿 → 東京 (Morning Rush)
Duration: 08:30発→08:44着 14分（乗車14分）
Cost: 208円
Transfers: 0

┌─ 新宿 → 東京 (JR中央線)
│  08:30→08:44 [14分] Platform: 7番線→2番線
└─ Next trains: 08:32, 08:34, 08:36 (every 2-3 minutes)

晚间路线与高峰时段

$ uv run jp-transit search "渋谷" "品川" --datetime "2025-11-07 18:00"

Route 1: 渋谷 → 品川 (Evening)
Duration: 18:03発→18:16着 13分（乗車13分）
Cost: 178円
Transfers: 0

┌─ 渋谷 → 品川 (JR山手線)
│  18:03→18:16 [13分] Platform: 2番線→1番線
└─ Frequent service: trains every 3-4 minutes

东京到大阪（最便宜的路线）

$ uv run jp-transit search "東京" "大阪" --search-type cheapest

Route 1: 東京 → 大阪 (Cheapest Option)
Duration: 16:03発→19:18着 3時間15分（乗車2時間58分）
Cost: 14,400円（乗車券8,910円　特別料金5,490円）
Transfers: 1

Transfer Details:
┌─ 東京 → 新大阪 (JR新幹線)
│  16:03→18:57 [2時間54分] Platform: 15番線→21番線
├─ 新大阪 → 大阪 (JR京都線)
│  19:14→19:18 [4分] Platform: 7番線→6番線
└─ Total: 3時間15分, ¥14,400 (¥320 cheaper than fastest)

东京经名古屋至大阪

$ uv run jp-transit search "東京" "大阪" --via "名古屋"

Route 1: 東京 → 大阪 (via 名古屋)
Duration: 15:48発→18:33着 2時間45分（乗車2時間31分）
Cost: 14,720円（乗車券8,910円　特別料金5,810円）
Transfers: 1

Transfer Details:
┌─ 東京 → 新大阪 (JR新幹線)
│  15:48→18:15 [2時間27分] Platform: 18番線→21番線
│  Passes through: 名古屋 (17:06) ✓
├─ 新大阪 → 大阪 (JR京都線)
│  18:29→18:33 [4分] Platform: 7番線→6番線
└─ Total: 2時間45分, ¥14,720

车站搜索结果

$ uv run jp-transit stations search "東京"

Found 10 stations matching "東京":

1. 東京 (JR東日本) - 東京都千代田区
   Lines: JR山手線, JR京浜東北線, JR東海道線, JR中央線
2. 東京駅 (東京メトロ) - 東京都千代田区
   Lines: 丸ノ内線

3. 東京国際空港 (京急電鉄) - 東京都大田区
   Lines: 京急空港線
4. 東京テレポート (りんかい線) - 東京都江東区
   Lines: りんかい線

5. 東京ビッグサイト (ゆりかもめ) - 東京都江東区
   Lines: ゆりかもめ東京臨海新交通臨海線

🛠️ 快速开始

安装

先决条件： Python 3.10+和 紫外线

# Install uv (if needed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
git clone 
cd jp-transit-search
uv sync

# Verify installation
uv run jp-transit --version

📱 CLI使用示例

搜索运输路线

# Basic route search
uv run jp-transit search "横浜" "新宿"
uv run jp-transit search "東京" "渋谷"

# With departure time
uv run jp-transit search "大船" "羽田空港" --datetime "2025-11-07 09:30"
uv run jp-transit search "新宿" "東京" --datetime "2025-11-07 08:30"

# Via stations (up to 3)
uv run jp-transit search "横浜" "渋谷" --via "新宿" --via "目黒"

# Different search types
uv run jp-transit search "東京" "大阪" --search-type cheapest
uv run jp-transit search "新宿" "品川" --search-type easiest

# JSON output for scripts
uv run jp-transit search "横浜" "豊洲" --format json

# Detailed output with all information
uv run jp-transit search "渋谷" "品川" --format detailed --verbose

车站管理

# Search for stations
uv run jp-transit stations search "東京"
uv run jp-transit stations search "新宿" --limit 5

# List stations by prefecture
uv run jp-transit stations list --prefecture "東京都" --limit 10

# Get detailed station info
uv run jp-transit stations info

🤖 MCP服务器设置

适用于人工智能助理（Claude Desktop等）

1. 启动MCP服务器：

   cd /path/to/jp-transit-search
   uv run jp-transit-mcp

1. 添加到您的AI助手配置 （例如，克劳德桌面）：

   {
     "mcpServers": {
       "jp-transit": {
         "command": "uv",
         "args": ["run", "jp-transit-mcp"],
         "cwd": "/path/to/jp-transit-search"
       }
     }
   }

1. 适用于AI助手的MCP工具：

- search_route -查找车站之间的路线 - search_stations -搜索电台数据库 - get_station_info -获取详细的车站信息 - list_station_database -按县浏览电台

测试MCP服务器

# Quick test
timeout 5s uv run jp-transit-mcp || echo "✅ Server started successfully"

# Test with Python
uv run python -c "
from jp_transit_search.mcp.server import TransitMCPServer
import asyncio

async def test():
    server = TransitMCPServer()
    result = await server._search_stations({'query': '東京'})
    print('✅ MCP server working:', len(result) > 0)

asyncio.run(test())
"

🛠️ 可用命令

CLI命令

jp-transit search FROM TO [OPTIONS]    # Search routes
jp-transit stations search QUERY       # Find stations
jp-transit stations list [OPTIONS]     # List stations
jp-transit stations info               # Database info
jp-transit config                      # Configuration

MCP工具（适用于AI助手）

• search_route：获取车站之间的交通路线
• 搜索_状态：通过模糊匹配按名称查找电台
• get_station_info：详细的车站信息
• list_station_database：浏览电台数据库

🧪 测试

# Run all tests
uv run pytest

# Run specific tests
uv run pytest tests/unit/test_mcp_server.py -v
uv run pytest tests/unit/test_cli.py -v

# Test with coverage
uv run pytest --cov=jp_transit_search

🔧 发展

# Linting and formatting
uv run ruff check src/ tests/
uv run ruff format src/ tests/

# Type checking
uv run mypy src/jp_transit_search/

# Install in development mode
uv pip install -e .

🌐 数据源

• 路由数据：雅虎运输（Transit.Yahoo.co.jp）
• 车站数据库：8291+日本火车站
• 实时：实时出发时间和路线信息

📄 特性

• ✅ 路线规划：在任何日本车站之间找到最佳路线
• ✅ 多种选择：最快、最便宜或最简单的路线
• ✅ 通过车站：规划最多3个中间站的路线
• ✅ 车站搜索：在8291+个站点上进行模糊搜索
• ✅ CLI接口：易于使用命令行
• ✅ MCP集成：与Claude等人工智能助手合作
• ✅ 多种格式：表、JSON或详细输出
• ✅ 实时数据：实时出发时间和延误
• ✅ 日期时间支持：搜索特定出发时间的路线

🆘 故障排除

常见问题

MCP服务器无法启动：

# Check dependencies
uv sync
uv run python -c "import jp_transit_search; print('✅ Package OK')"

路线搜索失败：

# Test with simple query
uv run jp-transit search "東京" "新宿" --verbose

车站搜索未返回任何结果：

# Check database
uv run jp-transit stations info

📈 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🤝 贡献

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 跑 uv run pytest 和 uv run ruff check
5. 提交拉取请求

______________________________________________________________________

需要帮助？ 在GitHub上打开一个问题或查看上面的故障排除部分。