@tcliplab/transit-mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,33 @@
-# Transit API Server
+# Transit API Server (UNOFFICIAL)
 
-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 can be tried without a local install or a separate service setup.
+It may be a small example of a local `npm` / `npx`-driven MCP wrapper.
+
+## 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,8 +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)) {
@@ -19,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;
@@ -196,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.1",
+  "version": "0.1.3",
   "license": "UNLICENSED",
   "type": "module",
   "publishConfig": {