Bus Nearby Mcp (israeli Transport Mcp).

Bus Nearby MCP（イスラエルの交通機関 MCP）。

イスラエルの交通機関 API にアクセスできる Model Context Protocol（MCP）サーバーです。
Bus Nearby API の非公式 MCP です。この API はこちらで確認できます

機能

https://github.com/user-attachments/assets/147ee388-e9c0-4f97-82e7-71d4d6534de0

• 🚍 ジオコーディング：場所の検索クエリを地理座標に変換します
• 🗺️ 経路検索：場所間の公共交通機関の経路を取得します
• 🌐 多言語対応：ヘブライ語と英語に対応しています
• 🔌 MCP プロトコル：標準的な MCP サーバー実装です
• 📦 Docker 対応：Docker による簡単なデプロイが可能です

Docker + Cursor ですぐに始める

前提条件

• Cursor IDE（またはその他の MCP クライアント）
• Docker Engine

セットアップ手順

1. MCP サーバーをセットアップします：

   {
     "mcpServers": {
       "busnearby-docker": {
         "command": "docker",
         "args": ["run", "--rm", "-i", "shmuelc/busnearby-mcp:latest"]
       }
     }
   }
   

Docker でローカル接続する

1. このリポジトリをクローンします

2. リポジトリのフォルダーに移動します

3. MCP サーバーをビルドしてセットアップします：

   docker build -t busnearby-mcp .
   

4. これを mcp.json に追加します

   {
     "mcpServers": {
       "busnearby": {
         "command": "docker",
         "args": [
           "run",
           "--rm",
           "-i",
           "--name",
           "busnearby-mcp-cursor",
           "busnearby-mcp"
         ],
         "env": {}
       }
     }
   }
   

Docker を使わずにローカル接続する

前提条件

• Node.js 18 以降がインストールされていること
• npm または yarn
• Cursor IDE

セットアップ手順

1. 依存関係をインストールします：

   npm install
   

2. プロジェクトをビルドします：

   npm run build
   

3. MCP サーバーをテストします：

   npm start
   

4. Cursor の MCP 設定に追加します：

   {
     "mcpServers": {
       "busnearby": {
         "command": "node",
         "args": ["/Users/shmuel/Desktop/personal/busnearby-mcp/dist/main.js"],
         "env": {}
       }
     }
   }
   

   重要： パスを実際のプロジェクトのパスに置き換えてください。

5. 新しい MCP サーバーを読み込むため、Cursor を再起動します

利用可能なツール

geocode

場所の検索クエリを座標に変換します。

パラメーター：

• locale：「he」または「en」（ヘブライ語または英語）
• query：場所を表す文字列（例：「תל אביב」または「Tel Aviv」）

例：

{
  "locale": "he",
  "query": "תל אביב"
}

directions

場所間の公共交通機関の経路を取得します。

パラメーター：

• fromPlace：出発地（"address::lat,lng"）
• toPlace：目的地（"address::lat,lng"）
• locale：「he」または「en」（デフォルト：「he」）
• arriveBy：到着時刻を基準に最適化します（デフォルト：false）
• wheelchair：車椅子で利用可能な経路にします（デフォルト：false）
• mode：交通手段（デフォルト：「WALK,TRANSIT」）
• numItineraries：経路の数（デフォルト：3）
• date：移動日（YYYY-MM-DD、任意）
• time：移動時刻（HH:MM、任意）

Docker コマンド

# Build the image
docker build -t busnearby-mcp .

# Run with docker-compose
docker-compose up -d

# Run interactively for testing
docker run --rm -i busnearby-mcp

# Test MCP protocol
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"clientInfo":{"name":"test","version":"1.0.0"}}}' | docker run --rm -i busnearby-mcp

開発

ローカル開発

npm install
npm run dev

ビルドとテスト

npm run build
npm start
npm run test:e2e

トラブルシューティング

Docker の問題

• Docker が実行中であることを確認してください
• 再ビルドを試してください：docker build --no-cache -t busnearby-mcp .
• ログを確認してください：docker logs busnearby-mcp

Cursor の接続に関する問題

• 設定を変更した後、Cursor を再起動してください
• MCP の設定パスが正しいことを確認してください
• Docker イメージが存在することを確認してください：docker images | grep busnearby-mcp

MCP プロトコルに関する問題

• サーバーを直接テストしてください：echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"clientInfo":{"name":"test","version":"1.0.0"}}}' | docker run --rm -i busnearby-mcp
• 応答が JSON-RPC 形式になっていることを確認してください

API リファレンス

この MCP サーバーは Bus Nearby API と連携し、以下を提供します。

• 複数言語での場所のジオコーディング
• 複数の交通手段に対応した経路検索
• リアルタイムの時刻表情報
• アクセシビリティ機能

すべての応答は、適切なエラー処理を備えた標準的な MCP プロトコル形式に従います。

貢献

お気軽に以下をお寄せください。

• 🐛 バグや問題の報告
• 💡 新機能や改善案の提案
• 📖 ドキュメントの改善
• 🔧 プルリクエストの送信

始め方：

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 十分にテストします
5. プルリクエストを送信します

あらゆる貢献を歓迎し、感謝いたします！