anyapi-mcp-server 1.5.0 → 1.5.1

package/build/api-client.js

@@ -34,7 +34,7 @@ export async function callApi(config, method, pathTemplate, params, body, extraH
     // --- URL construction ---
     const { url: interpolatedPath, remainingParams } = interpolatePath(pathTemplate, params ?? {});
     let fullUrl = `${config.baseUrl}${interpolatedPath}`;
-    if (method === "GET" && Object.keys(remainingParams).length > 0) {
+    if (Object.keys(remainingParams).length > 0) {
         const qs = new URLSearchParams();
         for (const [k, v] of Object.entries(remainingParams)) {
             if (v !== undefined && v !== null) {

package/build/api-index.js

@@ -118,19 +118,21 @@ function postmanUrlToPath(url) {
 export class ApiIndex {
     byTag = new Map();
     allEndpoints = [];
-    constructor(specContent) {
-        let parsed;
-        try {
-            parsed = JSON.parse(specContent);
-        }
-        catch {
-            parsed = yaml.load(specContent);
-        }
-        if (isPostmanCollection(parsed)) {
-            this.parsePostman(parsed);
-        }
-        else {
-            this.parseOpenApi(parsed, parsed);
+    constructor(specContents) {
+        for (const specContent of specContents) {
+            let parsed;
+            try {
+                parsed = JSON.parse(specContent);
+            }
+            catch {
+                parsed = yaml.load(specContent);
+            }
+            if (isPostmanCollection(parsed)) {
+                this.parsePostman(parsed);
+            }
+            else {
+                this.parseOpenApi(parsed, parsed);
+            }
         }
     }
     parseOpenApi(spec, rawSpec) {
@@ -251,6 +253,15 @@ export class ApiIndex {
         }
         tagList.push(endpoint);
     }
+    listAll() {
+        return this.allEndpoints.map((ep) => ({
+            method: ep.method,
+            path: ep.path,
+            summary: ep.summary,
+            tag: ep.tag,
+            parameters: ep.parameters,
+        }));
+    }
     listAllCategories() {
         const categories = [];
         for (const [tag, endpoints] of this.byTag) {
@@ -260,7 +271,9 @@ export class ApiIndex {
         return categories;
     }
     listAllByCategory(category) {
-        const endpoints = this.byTag.get(category) ?? [];
+        const lower = category.toLowerCase();
+        const key = [...this.byTag.keys()].find((k) => k.toLowerCase() === lower);
+        const endpoints = key ? this.byTag.get(key) : [];
         return endpoints.map((ep) => ({
             method: ep.method,
             path: ep.path,
@@ -270,11 +283,18 @@ export class ApiIndex {
         }));
     }
     searchAll(keyword) {
-        const lower = keyword.toLowerCase();
+        let matcher;
+        try {
+            const re = new RegExp(keyword, "i");
+            matcher = (text) => re.test(text);
+        }
+        catch {
+            const lower = keyword.toLowerCase();
+            matcher = (text) => text.toLowerCase().includes(lower);
+        }
         return this.allEndpoints
-            .filter((ep) => ep.path.toLowerCase().includes(lower) ||
-            ep.summary.toLowerCase().includes(lower) ||
-            ep.description.toLowerCase().includes(lower))
+            .filter((ep) => matcher(ep.path) ||
+            matcher(ep.summary))
             .map((ep) => ({
             method: ep.method,
             path: ep.path,

package/build/config.js

@@ -56,7 +56,7 @@ const USAGE = `Usage: anyapi-mcp --name <name> --spec <path-or-url> --base-url <
 
 Required:
   --name       Server name (e.g. "petstore")
-  --spec       Path or URL to OpenAPI spec (JSON or YAML). HTTPS URLs are cached locally.
+  --spec       Path or URL to OpenAPI spec (JSON or YAML) (repeatable for multiple specs)
   --base-url   API base URL (e.g. "https://api.example.com")
 
 Optional:
@@ -65,13 +65,13 @@ Optional:
   --log        Path to request/response log file (NDJSON format)`;
 export async function loadConfig() {
     const name = getArg("--name");
-    const specUrl = getArg("--spec");
+    const specUrls = getAllArgs("--spec");
     const baseUrl = getArg("--base-url");
-    if (!name || !specUrl || !baseUrl) {
+    if (!name || specUrls.length === 0 || !baseUrl) {
         console.error(USAGE);
         process.exit(1);
     }
-    const spec = await loadSpec(interpolateEnv(specUrl));
+    const specs = await Promise.all(specUrls.map((url) => loadSpec(interpolateEnv(url))));
     const headers = {};
     for (const raw of getAllArgs("--header")) {
         const colonIdx = raw.indexOf(":");
@@ -86,7 +86,7 @@ export async function loadConfig() {
     const logPath = getArg("--log");
     return {
         name,
-        spec,
+        specs,
         baseUrl: interpolateEnv(baseUrl).replace(/\/+$/, ""),
         headers: Object.keys(headers).length > 0 ? headers : undefined,
         logPath: logPath ? resolve(logPath) : undefined,

package/build/index.js

@@ -11,33 +11,30 @@ import { getOrBuildSchema, executeQuery, schemaToSDL, truncateIfArray, computeSh
 const WRITE_METHODS = new Set(["POST", "PUT", "DELETE", "PATCH"]);
 const config = await loadConfig();
 initLogger(config.logPath ?? null);
-const apiIndex = new ApiIndex(config.spec);
+const apiIndex = new ApiIndex(config.specs);
 const server = new McpServer({
     name: config.name,
     version: "1.2.1",
 });
 // --- Tool 1: list_api ---
 server.tool("list_api", `List available ${config.name} API endpoints. ` +
-    "Call with no arguments to see all categories. " +
-    "Provide 'category' to list endpoints in a tag. " +
-    "Provide 'search' to search across paths and descriptions. " +
-    "The correct query format is auto-selected based on mode. " +
-    "You can optionally override with a custom 'query' parameter. " +
+    "Call with no arguments to see all endpoints. " +
+    "Provide 'category' to filter by tag. " +
+    "Provide 'search' to search across paths and summaries (supports regex). " +
     "Results are paginated with limit (default 20) and offset.", {
     category: z
         .string()
         .optional()
-        .describe("Tag/category to filter by. Omit to see all categories."),
+        .describe("Tag/category to filter by. Case-insensitive."),
     search: z
         .string()
         .optional()
-        .describe("Search keyword across endpoint paths and descriptions"),
+        .describe("Search keyword or regex pattern across endpoint paths and summaries"),
     query: z
         .string()
         .optional()
-        .describe("Optional GraphQL selection query override. If omitted, a sensible default is used automatically:\n" +
-        "Categories (no args): '{ items { tag endpointCount } _count }'\n" +
-        "Endpoints (with category/search): '{ items { method path summary tag parameters { name in required description } } _count }'"),
+        .describe("GraphQL selection query. Default: '{ items { method path summary } _count }'. " +
+        "Available fields: method, path, summary, tag, parameters { name in required description }"),
     limit: z
         .number()
         .int()
@@ -52,7 +49,6 @@ server.tool("list_api", `List available ${config.name} API endpoints. ` +
         .describe("Items to skip (default: 0)"),
 }, async ({ category, search, query, limit, offset }) => {
     try {
-        const isEndpointMode = !!(search || category);
         let data;
         if (search) {
             data = apiIndex.searchAll(search);
@@ -61,7 +57,7 @@ server.tool("list_api", `List available ${config.name} API endpoints. ` +
             data = apiIndex.listAllByCategory(category);
         }
         else {
-            data = apiIndex.listAllCategories();
+            data = apiIndex.listAll();
         }
         // Empty results — return directly to avoid GraphQL schema errors on empty arrays
         if (data.length === 0) {
@@ -71,11 +67,9 @@ server.tool("list_api", `List available ${config.name} API endpoints. ` +
                 ],
             };
         }
-        const defaultQuery = isEndpointMode
-            ? "{ items { method path summary tag parameters { name in required description } } _count }"
-            : "{ items { tag endpointCount } _count }";
+        const defaultQuery = "{ items { method path summary } _count }";
         const effectiveQuery = query ?? defaultQuery;
-        const { schema } = getOrBuildSchema(data, "LIST", category ?? search ?? "_categories");
+        const { schema } = getOrBuildSchema(data, "LIST", category ?? search ?? "_all");
         const { data: sliced, truncated, total } = truncateIfArray(data, limit ?? 20, offset);
         const queryResult = await executeQuery(schema, sliced, effectiveQuery);
         if (truncated && typeof queryResult === "object" && queryResult !== null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyapi-mcp-server",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "A universal MCP server that connects any REST API (via OpenAPI spec) to AI assistants, with GraphQL-style field selection and automatic schema inference.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",