mcp-server-public-transport

ヨーロッパ全域のリアルタイム公共交通機関データを提供するMCPサーバー。

概要

mcp-server-public-transportは、Model Context Protocol (MCP)互換のローカルサーバーで、ヨーロッパ全域の公共交通機関データへのアクセスを提供します。 現在、イギリス、スイス、ノルウェー、ベルギー、およびベルリン/ブランデンブルクのAPIを統合しており、列車の接続情報、リアルタイムの出発情報、バスの現在地などを取得できます。

Related MCP server: Berlin Transport MCP Server

機能実装状況

対応国

国別の機能

セットアップ

環境変数

以下の環境変数を設定してください：

UK_TRANSPORT_APP_ID=your_uk_app_id
UK_TRANSPORT_API_KEY=your_uk_api_key

Claude Desktopでの使用

claude_desktop_config.jsonに追加してください：

{
  "mcpServers": {
    "mcp-server-public-transport": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp-server-public-transport",
        "run",
        "server.py"
      ],
      "env": {
        "UK_TRANSPORT_APP_ID": "your-uk-app-id",
        "UK_TRANSPORT_API_KEY": "your-uk-api-key"
      }
    }
  }
}

/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-public-transportを、リポジトリをクローンした実際のパスに置き換えてください。

注：コマンドフィールドには、uv実行ファイルのフルパスを指定する必要がある場合があります。これは、MacOS/Linuxではwhich uv、Windowsではwhere uvを実行することで取得できます。

開発

開発環境の構築

1. リポジトリのクローン

git clone https://github.com/mirodn/mcp-server-public-transport.git
cd mcp-server-public-transport

2. 依存関係のインストール

uv sync

3. 環境変数の設定

cp .env.example .env

4. サーバーの実行

uv run server.py

テストの実行

このプロジェクトではテストにpytestを使用しており、以下のコマンドが利用可能です：

# Run all tests
make test

コード品質

# Run linting
make lint

# Run code formatting
make format

継続的インテグレーション

このプロジェクトには、GitHub Actionsワークフロー（.github/workflows/test.yml）が含まれており、自動的に以下を行います：

• Python 3.10、3.11、3.12でのテスト実行

• ruffを使用したリンティングチェックの実行

• mainブランチへのすべてのプッシュおよびプルリクエストで実行

CIパイプラインにより、変更がマージされる前に、サポートされているすべてのPythonバージョンでコードの品質と互換性が保証されます。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

パッケージは、pyproject.tomlでproject.versionが更新されると、自動的にPyPIにデプロイされます。 バージョニングにはセマンティックバージョニング（semver）に従ってください。

ライセンス

MIT License