@tcliplab/transit-mcp 0.1.0 → 0.1.2

package/README.md

@@ -1,11 +1,67 @@
 # Transit API Server
 
-An MCP server for Transit API, a Japanese public transit API built on `https://api.transit.ls8h.com/`.
+An unofficial local MCP server for Transit API, a Japanese public transit API built on `https://api.transit.ls8h.com/`.
 
-This server wraps the REST API and is still unofficial.
+In most cases, you should use the official MCP connector at `https://api.transit.ls8h.com/mcp`.
 
-I made this to search Japanese transit information seamlessly from LLM chat.
+This package exists as a local `npm` / `npx`-based wrapper and as a base for future wrapper tools and experiments.
+It also includes lightweight result previews, which may make the first-step UX a little smoother.
 
-## LICENSE
+Why `npx`: this package is packaged so it can be tried without a local install or a separate service setup.
+That may make it a useful example of how the same API can be wrapped as a local `npm` / `npx`-driven MCP server, with the distribution model and adapter layer being part of the value.
+
+## Available Tools
+
+These tools follow the shape and coverage of the original Transit API.
+
+- `plan_journey` - search a route between two places
+- `guidance_plan` - generate route guidance text
+- `suggest_locations` - search location candidates
+- `suggest_places` - search stations and place candidates
+- `get_station` - fetch station details
+- `get_station_departures` - fetch departures from a station
+- `list_feeds` - list available feeds
+- `list_operators` - list available operators
+
+## Install
+
+Use `npx` for quick access.
+
+If you prefer, you can build and run it yourself.
+
+## Connect Claude Desktop
+
+Add the server to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "transit-mcp": {
+      "command": "npx",
+      "args": ["-y", "@tcliplab/transit-mcp@beta"]
+    }
+  }
+}
+```
+
+## Connect Codex
+
+Add the server to your Codex config:
+
+```toml
+[mcp_servers.transit_mcp]
+command = "npx"
+args = ["-y", "@tcliplab/transit-mcp@beta"]
+```
+
+## API Documentation
+
+Transit API is available at `https://api.transit.ls8h.com/`.
+
+The server uses the public REST API directly and does not require extra credentials.
+
+## About
+
+This package is currently unofficial.
 
 No license is granted at this time. OSS release is planned after permission and scope are clarified.

package/build/index.js

@@ -1,7 +1,20 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/server";
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 import * as z from "zod/v4";
 const API_BASE = "https://api.transit.ls8h.com";
+const REQUEST_TIMEOUT_MS = 20_000;
+function readPackageVersion() {
+    try {
+        const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const SERVER_VERSION = readPackageVersion();
 function toSearchParams(params) {
     const searchParams = new URLSearchParams();
     for (const [key, value] of Object.entries(params)) {
@@ -18,24 +31,40 @@ async function fetchTransit(path, params = {}) {
     searchParams.forEach((value, key) => {
         url.searchParams.set(key, value);
     });
-    const response = await fetch(url, {
-        headers: {
-            accept: "application/json",
-        },
-    });
-    const rawText = await response.text();
-    let data = rawText;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+        controller.abort();
+    }, REQUEST_TIMEOUT_MS);
     try {
-        data = JSON.parse(rawText);
+        const response = await fetch(url, {
+            headers: {
+                accept: "application/json",
+            },
+            signal: controller.signal,
+        });
+        const rawText = await response.text();
+        let data = rawText;
+        try {
+            data = JSON.parse(rawText);
+        }
+        catch {
+            // Keep raw text when the endpoint does not return JSON.
+        }
+        if (!response.ok) {
+            const detail = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+            throw new Error(`Transit API ${response.status} ${response.statusText}: ${detail}`);
+        }
+        return data;
     }
-    catch {
-        // Keep raw text when the endpoint does not return JSON.
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new Error(`Transit API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+        }
+        throw error;
     }
-    if (!response.ok) {
-        const detail = typeof data === "string" ? data : JSON.stringify(data, null, 2);
-        throw new Error(`Transit API ${response.status} ${response.statusText}: ${detail}`);
+    finally {
+        clearTimeout(timeoutId);
     }
-    return data;
 }
 function formatServiceSeconds(seconds) {
     const day = 86_400;
@@ -195,7 +224,7 @@ const stationInput = z.object({
 });
 const server = new McpServer({
     name: "transit-mcp",
-    version: "1.0.0",
+    version: SERVER_VERSION,
 });
 server.registerTool("plan_journey", {
     title: "Plan journey",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tcliplab/transit-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "UNLICENSED",
   "type": "module",
   "publishConfig": {