Log inSubmit server
Chelaile MCP logo

Chelaile MCP

by PeanutSplash

Query China’s realtime bus and metro data, including arrivals, vehicle positions, stops, schedules, and transit routes.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Chelaile MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "peanutsplash-chelaile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "chelaile-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 15 tools correctly (1mo ago).

Overview

PeanutSplash/chelaile-mcp MCP server exposes Chelaile’s China transit data through MCP tools for buses and metros. It supports city lookup, keyword search, nearby stops, stop and line details, realtime arrivals, route geometry, timetables, and bus-plus-metro planning. Most tools use city IDs and coordinates, with WGS-84 required for stop and realtime queries and GCJ-02 required for transit planning. Reach for it when an agent needs current public-transit information in supported Chinese cities without user login or account credentials.

Use cases

  • Find the next bus arriving at a named stop
  • Search Chinese cities for bus lines and stations
  • Show live vehicles and route geometry on a map
  • Plan a bus-and-metro trip between two locations
  • Identify nearby stops from a user’s approximate location

Key features

  • Realtime bus arrivals and vehicle positions
  • China city, line, station, and POI search
  • Nearby stops with route and metro information
  • Bus and metro transit planning
  • WGS-84 reverse geocoding and location lookup
  • Markdown or JSON tool responses

Tools15

What Chelaile MCP lets your agent do. Expand a tool for its parameters.

Verified live~7.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/12 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · chelaile-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars24Stargazers on the source repository.
npm downloads116Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed15Callable tools this server registers over MCP.
Directory activity1 installsConfig copies, upvotes, and views on AllMCPs.

How Chelaile MCP works

What PeanutSplash/chelaile-mcp MCP server does

PeanutSplash/chelaile-mcp MCP server connects an MCP client to Chelaile transit data for cities in China. It covers both bus and metro use cases, including supported-city discovery, line and station search, nearby stop lookup, vehicle positions, arrival estimates, line schedules, and public-transit route planning.

The tool set supports several common workflows:

  • Find a city ID from a Chinese city name.
  • Search for a line, station, or point of interest.
  • Retrieve the stops and live vehicles for a bus line.
  • Check the nearest approaching bus at a selected stop.
  • Identify nearby bus stops from coordinates.
  • Plan a bus-and-metro journey between two places.

No login, account, or credential configuration is required according to the project documentation.

How it works

Start with bus_list_cities when the city ID is unknown. bus_search then resolves a line number, station, or destination into internal line and stop identifiers. Those identifiers feed into detail and realtime tools such as bus_get_line_detail, bus_get_stop_detail, and bus_get_line_realtime.

Location handling needs attention. bus_reverse_geocode accepts WGS-84 coordinates and returns a Chinese address plus city and administrative codes. bus_get_nearby_stops also expects WGS-84. bus_plan_transit instead expects GCJ-02 coordinates, which can be obtained from the POIs returned by bus_search. IP-based location from bus_get_my_location is only city-level and is not precise enough to identify an actual bus stop.

Every tool accepts response_format as markdown or json; markdown is the default. JSON is the useful choice when an agent needs coordinates, identifiers, vehicle arrays, or structured route segments.

Setup and configuration

Run the published npm package with npx:

Terminal
npx -y chelaile-mcp-server

For Claude Desktop, add the command and package as a server entry, then restart the client. The project’s examples use the server name chelaile.

PeanutSplash/chelaile-mcp MCP server has no documented environment variables or API key settings. Its IP-location feature calls the free tier of ip-api.com, which may be rate-limited. VPNs, proxies, and some cellular networks can reduce location accuracy.

Tools and capabilities

The available capabilities include:

  • List hot or complete sets of supported cities.
  • Read a city’s polling and arrival-display configuration.
  • Reverse-geocode WGS-84 coordinates into Chinese addresses.
  • Search lines, stations, and POIs, with paginated category results.
  • List nearby stops with passing lines and approaching vehicles.
  • Inspect stop details, line schedules, fares, first and last service times, and nearby metro lines.
  • Retrieve live buses, route polylines, and selected-stop ETAs.
  • Refresh multiple line-stop pairs in one request.
  • Plan alternative bus and metro routes with walking segments.

bus_get_line_detail is the preferred source for first and last service times and live vehicles. Subway results from bus_search should be handled through nearby-stop or transit-planning tools rather than the bus line-detail endpoint.

Limitations and notes

Realtime values come from the upstream service and can be missing or unknown. In particular, bus_get_line_realtime normally provides an ETA only for the nearest bus heading toward the selected stop; farther vehicles may have positions but no ETA. bus_list_line_buses is intended for imminent arrivals and may return only one or two vehicles, while line detail provides the broader live roster.

The timetable endpoint often returns a fixed interval instead of individual departures, especially for Shanghai lines. Route geometry is for map drawing and may omit a terminal stop, so the authoritative ordered stop list comes from line detail. The full city list is large and token-heavy, making the default hot-city list preferable unless a complete list is needed.

PeanutSplash/chelaile-mcp MCP server is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Chelaile MCP

Run `npx -y chelaile-mcp-server`.

Yes. Add an MCP server entry using `npx` with the `-y` flag and `chelaile-mcp-server` package, then restart Claude Desktop.

No login, account, or credential configuration is required according to the project documentation.

`bus_plan_transit` expects GCJ-02 coordinates. Nearby-stop and realtime bus tools use WGS-84 coordinates.

Related MCP servers

All in Travel & Transportation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewChelaile MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/peanutsplash-chelaile-mcp?style=directory)](https://allmcps.com/mcp/peanutsplash-chelaile-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/peanutsplash-chelaile-mcp"><img src="https://allmcps.com/api/badge/peanutsplash-chelaile-mcp?style=directory" alt="Chelaile MCP on AllMCPs" /></a>