MCP 服务器

matsumoto-buss-mcp

Provides Matsumoto city community bus information via GTFS data, enabling stop search, departure times, nearby stops, and route details.

README

松本バス MCP サーバー

松本市コミュニティバス情報を提供するModel Context Protocol (MCP)サーバーです。

概要

このMCPサーバーは、松本市が公開するGTFS-JP形式のバス情報を活用し、LLMが自然言語でバス情報を照会・提供できるようにします。観光客や市民が効率的にバスを利用できるよう支援します。

特徴

バス停検索: 名前による部分一致検索
次発バス検索: 指定バス停からの次のバス発車時刻を取得
近隣バス停検索: GPS座標から最寄りのバス停を検索
路線情報: 路線の詳細と経由バス停の一覧
自動更新: GTFSデータの定期的な自動更新

インストール

必要要件

Python 3.10以上
pip

セットアップ

# リポジトリのクローン
git clone https://github.com/Takamasa045/matsumoto-buss-mcp.git
cd matsumoto-buss-mcp

# 依存関係のインストール
pip install -e .

使用方法

MCPサーバーとして起動

python -m matsumoto_bus_mcp

MCP設定ファイル

Claude Desktopやその他のMCPクライアントで使用する場合、設定ファイルに以下を追加してください：

{
  "mcpServers": {
    "matsumoto-bus": {
      "command": "python",
      "args": ["-m", "matsumoto_bus_mcp"],
      "cwd": "/path/to/matsumoto-buss-mcp"
    }
  }
}

利用可能なツール

1. search_bus_stops

バス停を名前で検索します（部分一致可）。

パラメータ:

stop_name (string, 必須): バス停名
limit (integer, オプション): 最大返却件数（デフォルト: 10）

例:

{
  "stop_name": "松本駅",
  "limit": 5
}

2. get_next_departures

指定バス停から指定時刻以降に出発する次のバスを検索します。

パラメータ:

stop_id (string, 必須): バス停ID
departure_time (string, オプション): 基準時刻（ISO 8601形式）
limit (integer, オプション): 返却件数（デフォルト: 5）
route_filter (string, オプション): 路線名フィルタ

例:

{
  "stop_id": "STOP_001",
  "limit": 3
}

3. find_nearby_stops

指定座標から最寄りのバス停を検索します。

パラメータ:

latitude (number, 必須): 緯度
longitude (number, 必須): 経度
radius (integer, オプション): 検索半径（メートル、デフォルト: 500）
limit (integer, オプション): 最大返却件数（デフォルト: 5）

例:

{
  "latitude": 36.2380,
  "longitude": 137.9723,
  "radius": 1000
}

4. get_route_info

路線の詳細情報と経由バス停一覧を取得します。

パラメータ:

route_id (string, 必須): 路線ID
direction (integer, オプション): 方向（0 or 1）

例:

{
  "route_id": "ROUTE_001",
  "direction": 0
}

5. list_all_routes

運行中の全路線一覧を取得します。

パラメータ: なし

データソース

プライマリデータ: GTFSデータポータル
ライセンス: CC-BY 4.0（松本市オープンデータ利用規約）
更新頻度: 松本市による更新タイミングに準拠

技術スタック

MCP SDK: Model Context Protocol実装
データベース: SQLite
GTFS処理: Python標準ライブラリ
地理計算: Haversine公式による距離計算

プロジェクト構造

matsumoto-buss-mcp/
├── src/
│   └── matsumoto_bus_mcp/
│       ├── __init__.py
│       ├── __main__.py
│       ├── server.py          # MCPサーバーメイン
│       ├── config.py          # 設定管理
│       ├── database.py        # データベース管理
│       ├── gtfs_loader.py     # GTFSデータローダー
│       └── bus_service.py     # バス情報検索サービス
├── data/                      # データディレクトリ
├── logs/                      # ログディレクトリ
├── pyproject.toml            # プロジェクト設定
└── README.md