@qodalis/mcp-cli 0.0.0-stage → 0.1.0

package/dist/src/server.js

@@ -0,0 +1,86 @@
+import { createRequire } from 'node:module';
+import { ProtocolError, Server } from '@modelcontextprotocol/server';
+import { RemoteError } from './errors.js';
+import { isToolAllowed } from './filters.js';
+const require = createRequire(import.meta.url);
+/** package.json sits one level up from src/ and two levels up from dist/src/. */
+const readPackageJson = () => {
+    for (const candidate of ['../package.json', '../../package.json']) {
+        try {
+            return require(candidate);
+        }
+        catch {
+            // try the next location
+        }
+    }
+    return { name: '@qodalis/mcp-cli', version: '0.0.0' };
+};
+const packageJson = readPackageJson();
+export const SERVER_NAME = packageJson.name;
+export const SERVER_VERSION = packageJson.version;
+export const WEBSITE_URL = 'https://github.com/qodalis-solutions/mcp-cli';
+const INVALID_PARAMS = -32602;
+const INTERNAL_ERROR = -32603;
+export const buildInstructions = (config) => [
+    `Proxy to the Qodalis CLI server at ${config.url}.`,
+    "The tools are the server's CLI commands and features (files, data explorer, jobs, plugins), limited by the permissions of the configured account.",
+    'Call server_info first to see the server version and which features are enabled.',
+    config.readOnly
+        ? 'Read-only mode: only tools the server marks as read-only are available.'
+        : 'Tools that change data are available; check a tool’s description before calling it.',
+    'After a network or VPN interruption simply retry the call: the proxy reconnects automatically.',
+].join('\n');
+const errorResult = (message) => ({
+    content: [{ text: message, type: 'text' }],
+    isError: true,
+});
+/** Why a tool the server knows is hidden by the client-side settings. */
+const hiddenReason = (tool, config) => config.readOnly && tool.annotations?.readOnlyHint !== true
+    ? `Tool ${tool.name} is not available: QCLI_READ_ONLY allows only read-only tools.`
+    : `Tool ${tool.name} is not available: excluded by QCLI_TOOLS / QCLI_EXCLUDE.`;
+/**
+ * The local MCP server Claude Code talks to over stdio: `tools/list` returns the
+ * remote tools (unchanged) that pass the client-side filters, `tools/call` is forwarded.
+ */
+export const createProxyServer = (remote, config) => {
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION, websiteUrl: WEBSITE_URL }, {
+        capabilities: { tools: { listChanged: false } },
+        instructions: buildInstructions(config),
+    });
+    server.setRequestHandler('tools/list', async () => {
+        try {
+            const tools = await remote.listTools();
+            return { tools: tools.filter((tool) => isToolAllowed(tool, config)) };
+        }
+        catch (error) {
+            if (error instanceof ProtocolError) {
+                throw error;
+            }
+            throw new ProtocolError(INTERNAL_ERROR, error.message);
+        }
+    });
+    server.setRequestHandler('tools/call', async (request, ctx) => {
+        const params = request.params;
+        try {
+            const tool = await remote.findTool(params.name);
+            if (!tool) {
+                throw new ProtocolError(INVALID_PARAMS, `Unknown tool: ${params.name}`);
+            }
+            if (!isToolAllowed(tool, config)) {
+                throw new ProtocolError(INVALID_PARAMS, hiddenReason(tool, config));
+            }
+            return await remote.callTool({ arguments: params.arguments ?? {}, name: params.name }, ctx.mcpReq?.signal);
+        }
+        catch (error) {
+            if (error instanceof ProtocolError) {
+                throw error;
+            }
+            if (error instanceof RemoteError) {
+                return errorResult(error.message);
+            }
+            return errorResult(error?.message ?? String(error));
+        }
+    });
+    return server;
+};
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/package.json

@@ -1,6 +1,68 @@
 {
-  "name": "@qodalis/mcp-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@qodalis/mcp-cli",
+    "version": "0.1.0",
+    "description": "Model Context Protocol (MCP) server for Qodalis CLI servers: gives Claude Code the server's commands, files, data explorer and jobs through a resilient stdio proxy to the server's MCP endpoint.",
+    "type": "module",
+    "main": "dist/src/index.js",
+    "types": "dist/src/index.d.ts",
+    "bin": {
+        "mcp-cli": "dist/src/cli.js"
+    },
+    "files": [
+        "dist/src",
+        "LICENSE",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "engines": {
+        "node": ">=20.18.1"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "clean": "rm -rf dist",
+        "dev": "tsx src/cli.ts",
+        "typecheck": "tsc -p tsconfig.json --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"*.md\" \"vitest.config.ts\"",
+        "check-format": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"vitest.config.ts\"",
+        "prepublishOnly": "npm run clean && npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "qodalis",
+        "cli",
+        "claude",
+        "claude-code",
+        "ai",
+        "proxy"
+    ],
+    "author": "Nicolae Lupei <nicolae.lupei@qodalis.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/qodalis-solutions/mcp-cli.git"
+    },
+    "homepage": "https://github.com/qodalis-solutions/mcp-cli#readme",
+    "bugs": {
+        "url": "https://github.com/qodalis-solutions/mcp-cli/issues"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/client": "^2.3.1",
+        "@modelcontextprotocol/server": "^2.3.1",
+        "undici": "^7.30.1"
+    },
+    "devDependencies": {
+        "@types/node": "^22.20.5",
+        "@vitest/coverage-v8": "^5.0.5",
+        "prettier": "^3.9.10",
+        "tsx": "^4.23.15",
+        "typescript": "~5.9",
+        "vitest": "^5.0.5"
+    }
+}