ninerouter-mcp 1.0.1 → 1.1.0

package/dist/tools/web.js

@@ -1,29 +1,32 @@
-import { z } from "zod/v4";
-import { requestJson } from "../ninerouter-client.js";
-import { toPrettyJson, tryModelsWithFallback } from "./common.js";
+import { z } from 'zod/v4';
+import { requestJson } from '../ninerouter-client.js';
+import { tryModelsWithFallback, toPrettyJson } from './common.js';
 export function registerWebTools(server, config) {
-    server.registerTool("web_search", {
-        description: "Search the web through 9Router and return the raw search payload.",
+    server.registerTool('web_search', {
+        description: 'Search the web and return the raw upstream search payload as JSON. Use when the user needs current information, links, or news. Pass `model` (or its alias `provider`) to pick a specific search backend (e.g. `tavily/search`, `brave-search/search`); otherwise the configured `default_models.web_search` fallback chain is tried in order.',
         inputSchema: z.object({
-            query: z.string().min(1).describe("Search query to send to 9Router."),
-            model: z.string().optional().describe("9Router web-search model id, for example tavily/search or brave-search/search."),
-            provider: z.string().optional().describe("Alias for model; accepted for compatibility with 9Router docs."),
+            query: z.string().min(1).describe('Search query to send to the backend.'),
+            model: z
+                .string()
+                .optional()
+                .describe('Web-search model id, for example tavily/search or brave-search/search.'),
+            provider: z.string().optional().describe('Alias for model.'),
             maxResults: z.number().int().positive().max(20).optional().default(5),
-            searchType: z.enum(["web", "news"]).optional().default("web"),
+            searchType: z.enum(['web', 'news']).optional().default('web'),
             country: z.string().optional(),
             language: z.string().optional(),
             timeRange: z.string().optional(),
             domainFilter: z.string().optional(),
         }),
-    }, async ({ query, model, provider, maxResults, searchType, country, language, timeRange, domainFilter }) => {
+    }, async ({ query, model, provider, maxResults, searchType, country, language, timeRange, domainFilter, }) => {
         const userModel = model ?? provider;
         const defaultModels = config.defaultModels?.webSearch ?? [];
         const modelsToTry = userModel ? [userModel] : defaultModels;
         if (modelsToTry.length === 0) {
-            throw new Error("No model specified and no default_models.web_search configured.");
+            throw new Error('No model specified and no default_models.web_search configured.');
         }
         const payload = await tryModelsWithFallback(modelsToTry, async (selectedModel) => {
-            return await requestJson(config, "/v1/search", {
+            return await requestJson(config, '/v1/search', {
                 model: selectedModel,
                 query,
                 max_results: maxResults,
@@ -35,16 +38,19 @@ export function registerWebTools(server, config) {
             });
         });
         return {
-            content: [{ type: "text", text: toPrettyJson(payload) }],
+            content: [{ type: 'text', text: toPrettyJson(payload) }],
         };
     });
-    server.registerTool("web_fetch", {
-        description: "Fetch a URL through 9Router and return markdown, text, or HTML extraction output.",
+    server.registerTool('web_fetch', {
+        description: 'Fetch a URL and return its content as markdown (default), plain text, or HTML. Use when the user gives a link and you need its readable body. Output is truncated to `maxCharacters` (default 8000). Pass `model` (alias `provider`) to choose a fetcher (e.g. `jina-reader/fetch`, `firecrawl/fetch`); otherwise the configured `default_models.web_fetch` fallback chain is tried in order.',
         inputSchema: z.object({
-            url: z.string().url().describe("URL to fetch and extract."),
-            model: z.string().optional().describe("9Router web-fetch model id, for example jina-reader/fetch or firecrawl/fetch."),
-            provider: z.string().optional().describe("Alias for model; accepted for compatibility with 9Router docs."),
-            format: z.enum(["markdown", "text", "html"]).optional().default("markdown"),
+            url: z.string().url().describe('URL to fetch and extract.'),
+            model: z
+                .string()
+                .optional()
+                .describe('Web-fetch model id, for example jina-reader/fetch or firecrawl/fetch.'),
+            provider: z.string().optional().describe('Alias for model.'),
+            format: z.enum(['markdown', 'text', 'html']).optional().default('markdown'),
             maxCharacters: z.number().int().nonnegative().optional().default(8000),
         }),
     }, async ({ url, model, provider, format, maxCharacters }) => {
@@ -52,10 +58,10 @@ export function registerWebTools(server, config) {
         const defaultModels = config.defaultModels?.webFetch ?? [];
         const modelsToTry = userModel ? [userModel] : defaultModels;
         if (modelsToTry.length === 0) {
-            throw new Error("No model specified and no default_models.web_fetch configured.");
+            throw new Error('No model specified and no default_models.web_fetch configured.');
         }
         const payload = await tryModelsWithFallback(modelsToTry, async (selectedModel) => {
-            return await requestJson(config, "/v1/web/fetch", {
+            return await requestJson(config, '/v1/web/fetch', {
                 model: selectedModel,
                 url,
                 format,
@@ -63,7 +69,7 @@ export function registerWebTools(server, config) {
             });
         });
         return {
-            content: [{ type: "text", text: toPrettyJson(payload) }],
+            content: [{ type: 'text', text: toPrettyJson(payload) }],
         };
     });
 }

package/package.json

@@ -1,9 +1,12 @@
 {
     "name": "ninerouter-mcp",
-    "version": "1.0.1",
+    "version": "1.1.0",
     "type": "module",
     "description": "MCP server for 9Router with model discovery, automatic fallback, and type-safe validation",
     "license": "Apache-2.0",
+    "engines": {
+        "node": ">=20"
+    },
     "author": "Farhan Brillan Widyakirana <https://tojoo.dev>",
     "repository": {
         "type": "git",
@@ -39,16 +42,42 @@
         "prepack": "npm run build",
         "start": "node dist/index.js",
         "dev": "tsx watch src/index.ts",
-        "create-config": "tsx src/create-config.ts"
+        "create-config": "tsx src/create-config.ts",
+        "release": "semantic-release",
+        "lint": "eslint .",
+        "lint:fix": "eslint . --fix",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "typecheck": "tsc --noEmit",
+        "check": "npm run typecheck && npm run lint && npm run format:check",
+        "prepare": "husky"
     },
     "dependencies": {
-        "@modelcontextprotocol/server": "^2.0.0-beta.2",
-        "@iarna/toml": "^2.2.5",
-        "zod": "^4.0.0"
+        "@modelcontextprotocol/server": "^2.0.0-beta.4",
+        "toml": "^5.0.0",
+        "zod": "^4.4.3"
     },
     "devDependencies": {
-        "@types/node": "^22.0.0",
-        "tsx": "^4.19.0",
-        "typescript": "^5.6.0"
+        "@eslint/js": "^10.0.1",
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/npm": "^13.1.5",
+        "@types/node": "^22.20.0",
+        "eslint": "^10.7.0",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.0.0",
+        "prettier": "^3.9.5",
+        "semantic-release": "^25.0.7",
+        "tsx": "^4.23.1",
+        "typescript": "^6.0.3",
+        "typescript-eslint": "^8.64.0"
+    },
+    "lint-staged": {
+        "*.{ts,tsx,js,cjs,mjs}": [
+            "eslint --fix",
+            "prettier --write"
+        ],
+        "*.{json,md,yml,yaml}": [
+            "prettier --write"
+        ]
     }
 }