Bus Nearby Mcp (israeli Transport Mcp).

Bus Nearby MCP（以色列交通 MCP）。

一个提供以色列交通 API 访问能力的模型上下文协议（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. 重启 Cursor 以加载新的 MCP 服务

可用工具

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. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 充分测试
5. 提交拉取请求

欢迎并感谢所有贡献！