@id3-clarity/mcp-server 1.5.0

package/dist/config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+function loadConfig() {
+    const apiUrl = process.env.CLARITY_API_URL;
+    const apiToken = process.env.CLARITY_API_TOKEN;
+    if (!apiUrl)
+        throw new Error('CLARITY_API_URL env var required');
+    if (!apiToken)
+        throw new Error('CLARITY_API_TOKEN env var required');
+    if (!/^clr_[a-z0-9]{32}$/.test(apiToken)) {
+        throw new Error('CLARITY_API_TOKEN format invalid (expected: clr_<32 alphanumeric>)');
+    }
+    const lang = process.env.CLARITY_LANG === 'tr' ? 'tr' : 'en';
+    return { apiUrl: apiUrl.replace(/\/$/, ''), apiToken, lang };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAMA,gCAUC;AAVD,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/i18n/en.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    ready: string;
+    configError: string;
+};
+export default _default;

package/dist/i18n/en.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = { ready: 'CLARITY MCP Server ready', configError: 'Configuration error' };
+//# sourceMappingURL=en.js.map

package/dist/i18n/en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.js","sourceRoot":"","sources":["../../src/i18n/en.ts"],"names":[],"mappings":";;AAAA,kBAAe,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/i18n/tr.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    ready: string;
+    configError: string;
+};
+export default _default;

package/dist/i18n/tr.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = { ready: 'CLARITY MCP Server hazır', configError: 'Yapılandırma hatası' };
+//# sourceMappingURL=tr.js.map

package/dist/i18n/tr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.js","sourceRoot":"","sources":["../../src/i18n/tr.ts"],"names":[],"mappings":";;AAAA,kBAAe,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const config_1 = require("./config");
+const server_1 = require("./server");
+async function main() {
+    const config = (0, config_1.loadConfig)();
+    const server = (0, server_1.createServer)(config);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error(`@id3-clarity/mcp-server ready (lang=${config.lang})`);
+}
+main().catch((err) => {
+    console.error('Fatal:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,wEAAiF;AACjF,qCAAsC;AACtC,qCAAwC;AAExC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ServerConfig } from './config';
+export declare function createServer(config: ServerConfig): Server;

package/dist/server.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+/*
+ * ARCHITECTURAL DECISION: low-level `Server` API is intentional. DO NOT migrate
+ * to the high-level `McpServer` without re-validating the tool contract.
+ * --------------------------------------------------------------------------
+ * We use the low-level `Server` API (JSDoc-`@deprecated` in MCP SDK ≥1.x, but
+ * still fully exported and explicitly supported "for advanced use cases").
+ * Our 68 tool definitions in `src/tools/index.ts` are RAW JSON Schema objects
+ * derived from CLARITY's OpenAPI. The low-level ListTools handler advertises
+ * those schemas to clients VERBATIM, and CallTool forwards `arguments`
+ * untouched (CLARITY validates server-side).
+ *
+ * Why NOT `McpServer.registerTool` (verified against installed SDK 1.29.0):
+ *   1. `registerTool`'s `inputSchema` type is `ZodRawShapeCompat | AnySchema`
+ *      where `AnySchema = z3.ZodTypeAny | z4.$ZodType` — i.e. ZOD ONLY. There
+ *      is no raw-JSON-Schema escape hatch; passing our objects throws
+ *      "inputSchema must be a Zod schema or raw shape" (mcp.js:869).
+ *   2. McpServer builds `tools/list` by running each Zod schema through
+ *      `toJsonSchemaCompat` (zod→JSON-Schema). That output is NOT byte-equal
+ *      to our raw schemas: it injects `$schema`, and `z.string().uuid()`
+ *      expands to a `format:"uuid"` PLUS a `pattern` regex — diverging on all
+ *      63 uuid-typed params. MCP clients depend on this exact JSON, so it is a
+ *      breaking contract change.
+ *   3. McpServer additionally validates input client-side: Zod objects STRIP
+ *      unknown keys (or `.strict()` REJECTS) before the call — changing
+ *      today's pass-through semantics.
+ *
+ * The contract is locked by `server.contract.test.ts` (snapshot of all 68
+ * tools' tools/list output + verbatim-pass-through assertions). Run `npm test`.
+ *
+ * REVISIT TRIGGER: only migrate if a future SDK adds raw-JSON-Schema tool
+ * registration that preserves `tools/list` byte-for-byte AND keeps unknown-key
+ * pass-through — verify by running the contract test against the new path
+ * before deleting these eslint-disables.
+ */
+// eslint-disable-next-line @typescript-eslint/no-deprecated -- see header comment
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js"); // NOSONAR
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const clarity_api_client_1 = require("./client/clarity-api-client");
+const tools_1 = require("./tools");
+// eslint-disable-next-line @typescript-eslint/no-deprecated -- see header comment
+function createServer(config) {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- see header comment
+    const server = new index_js_1.Server(// NOSONAR
+    { name: '@id3-clarity/mcp-server', version: '1.5.0' }, { capabilities: { tools: {} } });
+    const client = new clarity_api_client_1.ClarityApiClient(config);
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: tools_1.TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description[config.lang] ?? t.description.en,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
+        // The CallToolRequestSchema infers `arguments` as
+        // Record<string, unknown> | undefined, so the previous `as` cast
+        // was a no-op (S4325). Default to {} and let the inferred type flow.
+        const args = req.params.arguments ?? {};
+        const result = await client.invokeTool(req.params.name, args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            isError: result.success === false && !result.requiresConfirmation,
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;AA0CA,oCA6BC;AAvED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,kFAAkF;AAClF,wEAAmE,CAAC,UAAU;AAC9E,iEAAmG;AAEnG,oEAA+D;AAC/D,mCAAgC;AAEhC,kFAAkF;AAClF,SAAgB,YAAY,CAAC,MAAoB;IAC/C,kFAAkF;IAClF,MAAM,MAAM,GAAG,IAAI,iBAAM,CAAE,UAAU;IACnC,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,EAAE,EACrD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,qCAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,aAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,EAAE;YAC3D,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5D,kDAAkD;QAClD,iEAAiE;QACjE,qEAAqE;QACrE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,oBAAoB;SAClE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+export interface ToolDefinition {
+    name: string;
+    description: {
+        tr: string;
+        en: string;
+    };
+    inputSchema: Record<string, unknown>;
+}
+export declare const TOOLS: ToolDefinition[];