NestDaddy

Taiwan TDX transport

io.github.amangeldievkuu/tdx-taiwan-mcp · v0.9.0

Taiwan transport via TDX: YouBike, buses, rail, flights, ferries, road traffic, parking, EV

Connect Runs on your machine

Terminal
claude mcp add tdx-taiwan-mcp -e TDX_CLIENT_ID=<TDX_CLIENT_ID> -e TDX_CLIENT_SECRET=<TDX_CLIENT_SECRET> -e TDX_REQUESTS_PER_SECOND=<TDX_REQUESTS_PER_SECOND> -e TDX_MAX_ITEMS=<TDX_MAX_ITEMS> -e TDX_TOOLS=<TDX_TOOLS> -e TDX_CACHE_DIR=<TDX_CACHE_DIR> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "tdx-taiwan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "TDX_CLIENT_ID": "<TDX_CLIENT_ID>",
        "TDX_CLIENT_SECRET": "<TDX_CLIENT_SECRET>",
        "TDX_REQUESTS_PER_SECOND": "<TDX_REQUESTS_PER_SECOND>",
        "TDX_MAX_ITEMS": "<TDX_MAX_ITEMS>",
        "TDX_TOOLS": "<TDX_TOOLS>",
        "TDX_CACHE_DIR": "<TDX_CACHE_DIR>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "tdx-taiwan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "TDX_CLIENT_ID": "<TDX_CLIENT_ID>",
        "TDX_CLIENT_SECRET": "<TDX_CLIENT_SECRET>",
        "TDX_REQUESTS_PER_SECOND": "<TDX_REQUESTS_PER_SECOND>",
        "TDX_MAX_ITEMS": "<TDX_MAX_ITEMS>",
        "TDX_TOOLS": "<TDX_TOOLS>",
        "TDX_CACHE_DIR": "<TDX_CACHE_DIR>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "tdx-taiwan-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "TDX_CLIENT_ID": "<TDX_CLIENT_ID>",
        "TDX_CLIENT_SECRET": "<TDX_CLIENT_SECRET>",
        "TDX_REQUESTS_PER_SECOND": "<TDX_REQUESTS_PER_SECOND>",
        "TDX_MAX_ITEMS": "<TDX_MAX_ITEMS>",
        "TDX_TOOLS": "<TDX_TOOLS>",
        "TDX_CACHE_DIR": "<TDX_CACHE_DIR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
TDX_CLIENT_ID
Required
TDX API key Client Id (tdx.transportdata.tw → 會員中心 → 資料服務 → API金鑰).
TDX_CLIENT_SECRET
Required, secret
TDX API key Client Secret.
TDX_REQUESTS_PER_SECOND
Optional
Client-side rate limit; match it to your TDX plan (0 turns it off).
TDX_MAX_ITEMS
Optional
Most items any tool returns.
TDX_TOOLS
Optional
Tool groups to load: bike, bus, rail, flight, ferry, road, parking, ev, raw; e.g. bus,rail or -road,-raw.
TDX_CACHE_DIR
Optional
Folder where static data is kept for a day between runs (default ~/.cache/tdx-taiwan-mcp); off turns it off.

Details

Package[email protected] (NPM, stdio)
First published2 Nov 2026
Last updated2 Nov 2026
Registry nameio.github.amangeldievkuu/tdx-taiwan-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.