@softacus-software/elwis-docs-mcp 0.1.1

package/dist/data-store.js

@@ -0,0 +1,119 @@
+const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+function RefName(ref) {
+    return ref.split('/').pop();
+}
+export class DataStore {
+    spec;
+    index;
+    opIndex = new Map();
+    constructor(spec, index) {
+        this.spec = spec;
+        this.index = index;
+        for (const path of Object.keys(spec.paths ?? {}))
+            for (const method of METHODS) {
+                const op = spec.paths[path][method];
+                if (op?.operationId)
+                    this.opIndex.set(op.operationId, { method: method.toUpperCase(), path, op });
+            }
+    }
+    GetEndpoint(operationId) {
+        const entry = this.opIndex.get(operationId);
+        if (!entry)
+            return undefined;
+        const op = entry.op;
+        const parameters = (op.parameters ?? []).map((p) => ({
+            name: p.name, in: p.in, required: !!p.required, type: p.schema?.type ?? (p.schema?.$ref ? RefName(p.schema.$ref) : 'unknown'),
+        }));
+        const auth = [];
+        for (const s of op.security ?? [])
+            for (const k of Object.keys(s))
+                auth.push(k);
+        const content = op.requestBody?.content ?? {};
+        const requestContentType = content['application/json'] ? 'application/json' : Object.keys(content)[0];
+        const reqSchema = requestContentType ? content[requestContentType]?.schema : undefined;
+        const responses = Object.keys(op.responses ?? {}).map(status => {
+            const sc = op.responses[status]?.content?.['application/json']?.schema;
+            return { status, schema: sc?.$ref ? RefName(sc.$ref) : undefined };
+        });
+        return {
+            operationId, method: entry.method, path: entry.path,
+            summary: op.summary ?? '', description: op.description ?? '',
+            parameters, auth,
+            requestContentType,
+            requestSchema: reqSchema?.$ref ? RefName(reqSchema.$ref) : undefined,
+            responses,
+        };
+    }
+    GetSchema(name, maxDepth) {
+        const schemas = this.spec.components?.schemas ?? {};
+        if (!schemas[name])
+            return undefined;
+        const BYTE_BUDGET = 24000;
+        const attempt = (depthLimit) => {
+            const truncatedRefs = [];
+            const missingRefs = [];
+            const inline = (node, depth, seen) => {
+                if (Array.isArray(node))
+                    return node.map(n => inline(n, depth, seen));
+                if (node && typeof node === 'object') {
+                    if (typeof node.$ref === 'string') {
+                        const refName = RefName(node.$ref);
+                        if (!schemas[refName]) {
+                            if (!missingRefs.includes(refName))
+                                missingRefs.push(refName);
+                            return { $ref: refName };
+                        }
+                        if (seen.has(refName) || depth >= depthLimit) {
+                            if (!truncatedRefs.includes(refName))
+                                truncatedRefs.push(refName);
+                            return { $ref: refName };
+                        }
+                        return inline(schemas[refName], depth + 1, new Set(seen).add(refName));
+                    }
+                    const out = {};
+                    for (const k of Object.keys(node))
+                        out[k] = inline(node[k], depth, seen);
+                    return out;
+                }
+                return node;
+            };
+            const schema = inline(schemas[name], 0, new Set([name]));
+            return { name, schema, depthUsed: depthLimit, requestedDepth: maxDepth, truncatedRefs, missingRefs };
+        };
+        for (let depth = maxDepth; depth > 0; depth--) {
+            const result = attempt(depth);
+            if (JSON.stringify(result.schema).length <= BYTE_BUDGET)
+                return result;
+        }
+        return attempt(0);
+    }
+    GetExamples(operationId) {
+        const entry = this.opIndex.get(operationId);
+        if (!entry)
+            return undefined;
+        const op = entry.op;
+        const requestExamples = Object.entries(op.requestBody?.content?.['application/json']?.examples ?? {})
+            .map(([name, ex]) => ({ name, value: ex.value }));
+        const responseExamples = [];
+        for (const status of Object.keys(op.responses ?? {})) {
+            const ct = op.responses[status]?.content?.['application/json'] ?? {};
+            for (const [name, ex] of Object.entries(ct.examples ?? {}))
+                responseExamples.push({ status, name, value: ex.value });
+            if (ct.example !== undefined && !Object.keys(ct.examples ?? {}).length)
+                responseExamples.push({ status, name: 'default', value: ct.example });
+            const schemaEx = ct.schema?.example ?? ct.schema?.allOf?.[0]?.example;
+            if (schemaEx !== undefined && !responseExamples.some(r => r.status === status))
+                responseExamples.push({ status, name: 'default', value: schemaEx });
+        }
+        const scenarios = [];
+        for (const sc of this.spec['x-elwis-scenarios'] ?? [])
+            for (const step of sc.steps ?? [])
+                if (step.operationId === operationId)
+                    scenarios.push({ scenarioId: sc.id, step });
+        return { operationId, requestExamples, responseExamples, scenarios };
+    }
+    ListGroups() {
+        return this.index.groups;
+    }
+}
+//# sourceMappingURL=data-store.js.map

package/dist/data-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../src/data-store.ts"],"names":[],"mappings":"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"}

package/dist/generate.js

@@ -0,0 +1,49 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { WalkOperations } from './spec-walk.js';
+export function Tokenize(input) {
+    const spaced = input.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+    const raw = spaced.toLowerCase().split(/[^a-z0-9]+/);
+    return Array.from(new Set(raw.filter(t => t.length > 1)));
+}
+export function BuildSearchIndex(spec) {
+    const ops = WalkOperations(spec).sort((a, b) => a.operationId.localeCompare(b.operationId));
+    const operations = ops.map(op => ({
+        ...op,
+        keywords: Tokenize([op.operationId, op.path, op.tag, op.summary].join(' ')),
+    }));
+    const groupMap = new Map();
+    for (const op of ops)
+        groupMap.set(op.tag, (groupMap.get(op.tag) ?? 0) + 1);
+    const tagDescriptions = {};
+    for (const tag of spec.tags ?? [])
+        tagDescriptions[tag.name] = tag.description ?? '';
+    const groups = Array.from(groupMap.entries())
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([tag, operationCount]) => ({ tag, description: tagDescriptions[tag] ?? '', operationCount }));
+    return { version: spec.info?.version ?? '0.0.0', operations, groups };
+}
+function StableSort(value) {
+    if (Array.isArray(value))
+        return value.map(StableSort);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const key of Object.keys(value).sort())
+            out[key] = StableSort(value[key]);
+        return out;
+    }
+    return value;
+}
+function Main() {
+    const specPath = resolve(process.argv[2] ?? 'data/openapi.json');
+    const dataDir = dirname(specPath);
+    const spec = JSON.parse(readFileSync(specPath, 'utf8'));
+    const index = BuildSearchIndex(spec);
+    writeFileSync(resolve(dataDir, 'search-index.json'), JSON.stringify(StableSort(index), null, 2) + '\n');
+    writeFileSync(specPath, JSON.stringify(StableSort(spec), null, 2) + '\n');
+    console.log(`Indexed ${index.operations.length} operations into ${dataDir}/search-index.json`);
+}
+if (import.meta.url === `file://${process.argv[1]}` || fileURLToPath(import.meta.url) === process.argv[1])
+    Main();
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { BuildServer } from './server.js';
+async function Main() {
+    const server = BuildServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+Main().catch(e => {
+    console.error(e);
+    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,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/search.js

@@ -0,0 +1,54 @@
+function QueryTokens(query) {
+    const spaced = query.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+    return [...new Set(spaced.toLowerCase().split(/[^a-z0-9]+/).filter(t => t.length > 1))];
+}
+function TokenMatch(token, keyword) {
+    if (keyword === token)
+        return 2;
+    if (token.endsWith('s') && keyword === token.slice(0, -1))
+        return 2;
+    if (keyword.endsWith('s') && token === keyword.slice(0, -1))
+        return 2;
+    if (keyword.startsWith(token) || (keyword.length > 2 && token.startsWith(keyword)))
+        return 1;
+    return 0;
+}
+function PrimaryResource(path) {
+    const segments = path.split('/').filter(s => s && s !== 'api' && !s.startsWith('{'));
+    if (segments.length > 1 && (segments[0] === 'tenant' || segments[0] === 'system' || segments[0] === 'internal'))
+        return segments[1];
+    return segments[0] ?? '';
+}
+export function SearchOperations(index, query, group, limit) {
+    const tokens = QueryTokens(query);
+    const pool = group ? index.operations.filter(o => o.tag === group) : index.operations;
+    const perOp = pool.map(op => ({
+        op,
+        resource: PrimaryResource(op.path),
+        matched: tokens.map(t => op.keywords.reduce((best, k) => Math.max(best, TokenMatch(t, k)), 0)),
+    }));
+    const poolSize = pool.length || 1;
+    const idf = tokens.map((_, i) => {
+        const df = perOp.reduce((n, x) => n + (x.matched[i] > 0 ? 1 : 0), 0);
+        return df > 0 ? Math.log(1 + poolSize / df) : 0;
+    });
+    const scored = perOp.map(({ op, resource, matched }) => {
+        let score = 0;
+        matched.forEach((m, i) => {
+            if (m === 0)
+                return;
+            score += m * idf[i];
+            if (TokenMatch(tokens[i], resource) === 2)
+                score += 2 * idf[i];
+        });
+        return { op, score };
+    });
+    const matches = scored
+        .filter(s => tokens.length === 0 || s.score > 0)
+        .sort((a, b) => b.score - a.score || a.op.operationId.localeCompare(b.op.operationId));
+    const results = matches
+        .slice(0, limit)
+        .map(s => ({ operationId: s.op.operationId, method: s.op.method, path: s.op.path, tag: s.op.tag, summary: s.op.summary }));
+    return { results, total: matches.length, returned: results.length, hasMore: matches.length > results.length };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -0,0 +1,72 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { DataStore } from './data-store.js';
+import { SearchOperations } from './search.js';
+function PackageRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..');
+}
+function Text(value) {
+    return { content: [{ type: 'text', text: JSON.stringify(value) }] };
+}
+function ErrorText(message) {
+    return { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true };
+}
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+export function BuildServer() {
+    const root = PackageRoot();
+    const pkg = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'));
+    const spec = JSON.parse(readFileSync(resolve(root, 'data', 'openapi.json'), 'utf8'));
+    const index = JSON.parse(readFileSync(resolve(root, 'data', 'search-index.json'), 'utf8'));
+    const store = new DataStore(spec, index);
+    const server = new McpServer({ name: 'elwis-docs-mcp', version: pkg.version });
+    server.registerTool('search_elwis_api', {
+        title: 'Search ELWIS API operations',
+        description: 'Search ELWIS API operations by keyword. Returns compact summaries with total/hasMore metadata. Start here; never guess endpoint paths.',
+        inputSchema: {
+            query: z.string().describe('Keywords to match against operation names, paths and tags'),
+            group: z.string().optional().describe('Restrict to one API group tag (see list_elwis_api_groups)'),
+            limit: z.number().int().positive().max(50).optional().describe('Maximum results to return (default 10)'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ query, group, limit }) => Text(SearchOperations(index, query, group, limit ?? 10)));
+    server.registerTool('list_elwis_api_groups', {
+        title: 'List ELWIS API groups',
+        description: 'List ELWIS API groups (tags) with operation counts.',
+        annotations: READ_ONLY,
+    }, async () => Text(store.ListGroups()));
+    server.registerTool('get_elwis_endpoint', {
+        title: 'Get ELWIS endpoint details',
+        description: 'Get details for one operation: method, path, params, auth, request content type and request/response schema names.',
+        inputSchema: { operationId: z.string().describe('Operation id from search_elwis_api results') },
+        annotations: READ_ONLY,
+    }, async ({ operationId }) => {
+        const d = store.GetEndpoint(operationId);
+        return d ? Text(d) : ErrorText(`Unknown operationId: ${operationId}`);
+    });
+    server.registerTool('get_elwis_schema', {
+        title: 'Get ELWIS schema',
+        description: 'Get one resolved JSON schema by component name. Refs are inlined up to maxDepth and the response is byte-bounded: depthUsed reports the depth actually served, truncatedRefs lists branches you can expand with another call, missingRefs lists refs absent from the spec.',
+        inputSchema: {
+            name: z.string().describe('Schema component name, e.g. from an endpoint requestSchema field'),
+            maxDepth: z.number().int().positive().max(6).optional().describe('Ref inlining depth to attempt (default 3); the server lowers it if the response would be too large'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ name, maxDepth }) => {
+        const r = store.GetSchema(name, maxDepth ?? 3);
+        return r ? Text(r) : ErrorText(`Unknown schema: ${name}`);
+    });
+    server.registerTool('get_elwis_examples', {
+        title: 'Get ELWIS endpoint examples',
+        description: 'Get request/response examples and scenario steps for one operation.',
+        inputSchema: { operationId: z.string().describe('Operation id from search_elwis_api results') },
+        annotations: READ_ONLY,
+    }, async ({ operationId }) => {
+        const e = store.GetExamples(operationId);
+        return e ? Text(e) : ErrorText(`Unknown operationId: ${operationId}`);
+    });
+    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":"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"}

package/dist/spec-walk.js

@@ -0,0 +1,21 @@
+const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+export function WalkOperations(spec) {
+    const out = [];
+    const paths = spec.paths ?? {};
+    for (const path of Object.keys(paths)) {
+        for (const method of METHODS) {
+            const op = paths[path][method];
+            if (!op || !op.operationId)
+                continue;
+            out.push({
+                operationId: op.operationId,
+                method: method.toUpperCase(),
+                path,
+                tag: Array.isArray(op.tags) && op.tags.length > 0 ? op.tags[0] : 'untagged',
+                summary: op.summary ?? '',
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=spec-walk.js.map

package/dist/spec-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-walk.js","sourceRoot":"","sources":["../src/spec-walk.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE1D,MAAM,UAAU,cAAc,CAAC,IAAS;IACtC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,WAAW;gBAAE,SAAS;YACrC,GAAG,CAAC,IAAI,CAAC;gBACP,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;gBAC5B,IAAI;gBACJ,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;gBAC3E,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@softacus-software/elwis-docs-mcp",
+  "version": "0.1.1",
+  "description": "Read-only Model Context Protocol server for the ELWIS API documentation, generated from the OpenAPI specification.",
+  "type": "module",
+  "bin": {
+    "elwis-docs-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc && shx chmod +x dist/index.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "lint": "eslint .",
+    "export-spec": "tsx scripts/export-spec.ts",
+    "generate": "tsx src/generate.ts data/openapi.json",
+    "refresh": "npm run export-spec && npm run generate",
+    "check-drift": "tsx scripts/check-drift.ts",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "tsx --test test/*.test.ts",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.0.1",
+    "eslint": "^10.6.0",
+    "shx": "^0.4.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.softacus.com/elwis/readonly-mcp.git"
+  },
+  "bugs": {
+    "url": "https://git.softacus.com/elwis/readonly-mcp/-/issues"
+  },
+  "homepage": "https://git.softacus.com/elwis/readonly-mcp#readme",
+  "keywords": [
+    "modelcontextprotocol",
+    "mcp",
+    "elwis",
+    "softacus",
+    "openapi",
+    "api-documentation"
+  ],
+  "license": "UNLICENSED"
+}