convez.ai
MCP ServerIntegração & APIsIntermediário
ymyzk

Nagoya Bus MCP

ymyzk/nagoya-bus-mcp

Consulte horários e posição de ônibus de Nagoya via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta Claude e outros LLMs aos dados públicos de ônibus da cidade de Nagoya. Oferece consultas em tempo real de paradas, horários e posicionamento de veículos através de interface natural em linguagem.

Instalação

$npx convez-ai ymyzk/nagoya-bus-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
2
Acompanhando
1
Saúde
42%
Último commit
há 5 dias
Versão
v0.10.0
Issues abertas
10
Contribuidores
6

Casos de uso

  • Planejamento de trajetos em Nagoya consultando horários em tempo real
  • Integração de dados de transporte público em aplicações de mobilidade
  • Assistentes de viagem que precisam acessar informações de ônibus locais

Veredito

MCP server bem implementado que democratiza acesso aos dados públicos de transporte de Nagoya. Útil principalmente para quem trabalha com mobilidade urbana ou assistentes baseados em LLM, mas com aplicabilidade geograficamente limitada.

README

A tradução para o português deste README ainda está na fila.

nagoya-bus-mcp

PyPI - Version PyPI - Python Version CI

English | 日本語

Overview

Nagoya Bus MCP is a Model Context Protocol (MCP) server that lets LLMs query Nagoya City bus information. Built with FastMCP, it exposes tools and prompts for looking up bus stops, reading timetables, and checking real-time bus approach and position information. Data is sourced from the public Nagoya City bus website.

Once connected to an MCP client such as Claude Desktop, you can ask questions like "When is the next bus from Nagoya Station?" in natural language and get answers backed by live data.

Features

The server exposes the following tools:

  • get_station_number — find a bus stop number from a stop name (with fuzzy matching).
  • get_timetable — departure timetables for every route at a bus stop, organized by day of week.
  • get_approach_for_route — real-time bus positions and latest passage times along a route.
  • get_approach_for_station — real-time approaching buses for all routes at a bus stop.

It also provides prompt templates ask_timetable and ask_bus_approach for common questions.

Example queries

Bus data is in Japanese, so queries work best in Japanese:

  • 「名古屋駅のバスの時刻表を教えて」 (What's the bus timetable at Nagoya Station?)
  • 「栄のバスの接近情報を教えて」 (Show real-time bus approach info at Sakae.)
  • 「新栄町のバス停番号を教えて」 (What's the bus stop number for Shin-sakaemachi?)

Getting started

The Nagoya Bus MCP server is published to PyPI.

Claude Desktop

Add the following configuration to claude_desktop_config.json.

{
  "mcpServers": {
    "nagoya-bus": {
      "command": "uvx",
      "args": ["nagoya-bus-mcp"]
    }
  }
}

Visual Studio Code

Add the following configuration to .vscode/mcp.json.

{
  "servers": {
    "nagoya-bus": {
      "type": "stdio",
      "command": "uvx",
      "args": ["nagoya-bus-mcp"],
      "env": {}
    }
  }
}

Manual

# Using uvx
$ uvx nagoya-bus-mcp

# Using Docker
$ docker run -i --rm ghcr.io/ymyzk/nagoya-bus-mcp

For developers

# Use MCP Inspector
$ npx @modelcontextprotocol/inspector uv run nagoya-bus-mcp

# Try API client
$ uv run python -m nagoya_bus_mcp.client

Data source

This project queries the public Nagoya City bus website (https://www.kotsu.city.nagoya.jp). It is an unofficial project and is not affiliated with or endorsed by the City of Nagoya.

Ver o original no GitHub

Bom para

Relacionados