@configcat/mcp-server 0.1.2

package/build/tools/configcat-docs.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { HttpClient } from "../http";
+export declare function registerConfigCatDocsTools(server: McpServer, http: HttpClient): Promise<void>;
+//# sourceMappingURL=configcat-docs.d.ts.map

package/build/tools/configcat-docs.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+const LLMS_TXT_URL = "https://configcat.com/docs/llms.txt";
+function extractMarkdownSection(content, sectionHeader) {
+    const sectionIndex = content.indexOf(sectionHeader);
+    if (sectionIndex !== -1) {
+        const rest = content.substring(sectionIndex + sectionHeader.length);
+        const nextHeadingIndex = rest.search(/\n###\s+/); // looks for "\n### ..."
+        let endIndex;
+        if (nextHeadingIndex !== -1) {
+            endIndex = sectionIndex + sectionHeader.length + nextHeadingIndex;
+        }
+        else {
+            endIndex = content.length;
+        }
+        // Extract just that section
+        return content.substring(sectionIndex, endIndex).trim();
+    }
+    return "";
+}
+export async function registerConfigCatDocsTools(server, http) {
+    const response = await http.fetch(LLMS_TXT_URL);
+    if (!response.ok) {
+        console.error(`Failed to fetch ${LLMS_TXT_URL} - HTTP ${response.status}: ${response.statusText}`);
+        return;
+    }
+    const sdkDocs = extractMarkdownSection(await response.text(), "### SDK Reference");
+    if (!sdkDocs) {
+        console.error(`Failed to extract SDK Reference section from ${LLMS_TXT_URL}`);
+        return;
+    }
+    server.tool("update-sdk-documentation", `If the user asks for coding related to a feature flag (such as integrating the ConfigCat SDK, adding a feature flag, or removing a feature flag), 
+    always call the tool "update-sdk-documentation" first to download the latest ConfigCat SDK documentation.
+
+    1. Analyze the SDK URLs listed in the following SDK Reference list.
+    2. Then call the tool "update-sdk-documentation" with specific URL from the SDK Reference list to fetch relevant documentation page.
+    
+    ${sdkDocs}`, {
+        url: z.string().url().describe("The URL to fetch SDK documentation from."),
+    }, async ({ url }) => {
+        try {
+            console.error(`Fetching documentation from: ${url}`);
+            const response = await http.fetch(url);
+            if (!response.ok) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error: Failed to fetch ${url} - HTTP ${response.status}: ${response.statusText}`,
+                        }],
+                    isError: true,
+                };
+            }
+            const content = await response.text();
+            console.error(`Successfully fetched ${content.length} characters from ${url}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: content,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching documentation:", error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=configcat-docs.js.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@configcat/mcp-server",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "MCP server exposing ConfigCat Public Management API (products, configs, environments, values v1/v2).",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "mcp-server": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "start": "node build/index.js",
+    "dev": "npm run build -- --watch",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "lint:check": "eslint . --max-warnings 0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/configcat/configcat-mcp.git"
+  },
+  "keywords": [
+    "configcat",
+    "featureflags",
+    "feature flags",
+    "feature toggle",
+    "feature switch",
+    "mcp",
+    "modelcontextprotocol"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.4",
+    "json-schema-to-zod": "^2.6.1",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "author": "ConfigCat",
+  "license": "MIT",
+  "homepage": "https://configcat.com",
+  "sideEffects": false,
+  "devDependencies": {
+    "@eslint/js": "^9.33.0",
+    "@stylistic/eslint-plugin": "^5.2.3",
+    "@types/node": "^22.7.4",
+    "eslint": "^9.33.0",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.3.0",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.40.0"
+  }
+}