@sit-onyx/modelcontextprotocol 0.1.0-dev-20260409103041 → 0.1.0-dev-20260410085526

package/README.md

@@ -0,0 +1,65 @@
+# onyx MCP
+
+This is the official [onyx](https://onyx.schwarz/) Model Context Protocol (or "MCP" for short) server.
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/en) version as specified in [.node-version](./.node-version) file
+
+## Getting started
+
+Install the CLI globally:
+
+```shell
+# npm
+npm install -g @sit-onyx/modelcontextprotocol
+
+# pnpm
+pnpm install -g @sit-onyx/modelcontextprotocol
+
+```
+
+Now you can run the `onyx-mcp` command:
+
+```shell
+onyx-mcp -h
+```
+
+### Using with the Gemini CLI
+
+Add this entry to your Gemini settings (in `~/.gemini/settings.json`):
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/google-gemini/gemini-cli/main/schemas/settings.schema.json",
+  "mcp": {
+    "allowed": ["onyx-mcp"]
+  },
+  "mcpServers": {
+    "onyx-mcp": {
+      "description": "Information about components of the onyx UI component library",
+      "command": "onyx-mcp",
+      "args": ["-r"]
+    }
+  }
+}
+```
+
+Save the file and confirm that the MCP has been set up correctly:
+
+```shell
+gemini mcp list
+```
+
+## Development
+
+Run this command in the monorepo root:
+
+```shell
+pnpm run dev modelcontextprotocol
+```
+
+This starts the "build" watcher and the [`@modelcontextprotocol/inspector`](https://github.com/modelcontextprotocol/inspector) locally.
+
+You must reload the inspector browser website after changes to the `@sit-onyx/modelcontextprotocol` source code.
+**Using the "Reconnect" button does not suffice!**

package/dist/index.d.ts

@@ -1,20 +1,22 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer as McpServer_2 } from '@modelcontextprotocol/sdk/server/mcp';
+
+export declare const createServer: ({ resourcesAsTools }: CreateServerOptions) => McpServer;
+
+declare type CreateServerOptions = {
+    resourcesAsTools: boolean;
+};
 
 /**
  * MCP server running as a http server.
  * `HOST` and `PORT` environment variable can be used to change the server settings.
  */
-export declare const http: () => Promise<void>;
-
-/**
- * Internal McpServer, which provides the MCP resources.
- */
-export declare const server: McpServer;
+export declare const http: (server: McpServer_2) => Promise<void>;
 
 /**
  * MCP server running via stdio.
  * All logging has to use stderr, otherwise the logging to stdio will break the transport.
  */
-export declare const stdio: () => Promise<void>;
+export declare const stdio: (server: McpServer_2) => Promise<void>;
 
 export { }

package/dist/index.js

@@ -4,7 +4,7 @@ import { error, log } from "node:console";
 import { parseArgs } from "node:util";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { randomUUID } from "node:crypto";
-import { createServer } from "node:http";
+import { createServer as createServer$1 } from "node:http";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { Readable } from "node:stream";
 import { buffer } from "node:stream/consumers";
@@ -66,7 +66,7 @@ var package_default = {
 	scripts: {
 		"dev": "pnpm run \"/build-dev|inspect-mcp/\"",
 		"build-dev": "vite build --ssr -w",
-		"inspect-mcp": "pnpm dlx @modelcontextprotocol/inspector node ./dist/index.js",
+		"inspect-mcp": "pnpm dlx @modelcontextprotocol/inspector --config inspector.json",
 		"build": "vite build --ssr"
 	},
 	dependencies: { "@modelcontextprotocol/sdk": "^1.29.0" },
@@ -79,10 +79,37 @@ var package_default = {
 		"typescript": "catalog:",
 		"vite": "catalog:",
 		"vite-plugin-dts": "^4.5.4",
-		"vue-component-meta": "^3.2.6"
+		"vue-component-meta": "^3.2.6",
+		"zod": "^4.3.6"
 	},
 	engines: { "node": ">=20" }
 };
+//#endregion
+//#region src/server/http.ts
+/**
+* MCP server running as a http server.
+* `HOST` and `PORT` environment variable can be used to change the server settings.
+*/
+var run = async (server) => {
+	const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID() });
+	await server.connect(transport);
+	const httpServer = createServer$1(transport.handleRequest);
+	const PORT = Number.parseInt(process.env["PORT"] ?? "3000");
+	const HOST = process.env["HOST"] ?? "0.0.0.0";
+	httpServer.listen(PORT, HOST);
+	log(`MCP http server listening on ${HOST}:${PORT}.`);
+};
+//#endregion
+//#region src/config.ts
+var { version: version$2 } = package_default;
+var USER_AGENT = `onyx-mcp/${version$2}`;
+var REGISTRY_URL = process.env.REGISTRY_URL ?? "https://registry.npmjs.org";
+/**
+* Minimum `sit-onyx` version that provides the `component-meta.json` file
+*/
+var SIT_ONYX_MIN_VERSION = "1.12.0";
+var SIT_ONYX_COMPONENT_META_FILE = "package/dist/component-meta.json";
+var SIT_ONYX_ICONS_METADATA_FILE = "package/dist/metadata.json";
 Object.freeze({ status: "aborted" });
 function $constructor(name, initializer, params) {
 	function init(inst, def) {
@@ -522,6 +549,7 @@ var _parse = (_Err) => (schema, value, _ctx, _params) => {
 	}
 	return result.value;
 };
+var parse$1 = /* @__PURE__ */ _parse($ZodRealError);
 var _parseAsync = (_Err) => async (schema, value, _ctx, params) => {
 	const ctx = _ctx ? Object.assign(_ctx, { async: true }) : { async: true };
 	let result = schema._zod.run({
@@ -536,6 +564,7 @@ var _parseAsync = (_Err) => async (schema, value, _ctx, params) => {
 	}
 	return result.value;
 };
+var parseAsync$1 = /* @__PURE__ */ _parseAsync($ZodRealError);
 var _safeParse = (_Err) => (schema, value, _ctx) => {
 	const ctx = _ctx ? {
 		..._ctx,
@@ -648,7 +677,7 @@ function datetime$1(args) {
 	const timeRegex = `${time}(?:${opts.join("|")})`;
 	return new RegExp(`^${dateSource}T(?:${timeRegex})$`);
 }
-var string$1 = (params) => {
+var string$2 = (params) => {
 	const regex = params ? `[\\s\\S]{${params?.minimum ?? 0},${params?.maximum ?? ""}}` : `[\\s\\S]*`;
 	return new RegExp(`^${regex}$`);
 };
@@ -1049,7 +1078,7 @@ var Doc = class {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/versions.js
-var version$2 = {
+var version$1 = {
 	major: 4,
 	minor: 3,
 	patch: 6
@@ -1061,7 +1090,7 @@ var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
 	inst ?? (inst = {});
 	inst._zod.def = def;
 	inst._zod.bag = inst._zod.bag || {};
-	inst._zod.version = version$2;
+	inst._zod.version = version$1;
 	const checks = [...inst._zod.def.checks ?? []];
 	if (inst._zod.traits.has("$ZodCheck")) checks.unshift(inst);
 	for (const ch of checks) for (const fn of ch._zod.onattach) fn(inst);
@@ -1146,7 +1175,7 @@ var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
 });
 var $ZodString = /* @__PURE__ */ $constructor("$ZodString", (inst, def) => {
 	$ZodType.init(inst, def);
-	inst._zod.pattern = [...inst?._zod.bag?.patterns ?? []].pop() ?? string$1(inst._zod.bag);
+	inst._zod.pattern = [...inst?._zod.bag?.patterns ?? []].pop() ?? string$2(inst._zod.bag);
 	inst._zod.parse = (payload, _) => {
 		if (def.coerce) try {
 			payload.value = String(payload.value);
@@ -3529,7 +3558,7 @@ var ZodString = /* @__PURE__ */ $constructor("ZodString", (inst, def) => {
 	inst.time = (params) => inst.check(time(params));
 	inst.duration = (params) => inst.check(duration(params));
 });
-function string(params) {
+function string$1(params) {
 	return /* @__PURE__ */ _string(ZodString, params);
 }
 var ZodStringFormat = /* @__PURE__ */ $constructor("ZodStringFormat", (inst, def) => {
@@ -4008,34 +4037,34 @@ function superRefine(fn) {
 }
 //#endregion
 //#region ../../node_modules/.pnpm/zod-package-json@2.1.0_zod@4.3.6/node_modules/zod-package-json/dist/package-json.js
-var Bugs = union([string(), object({
-	url: optional(string()),
-	email: optional(string())
+var Bugs = union([string$1(), object({
+	url: optional(string$1()),
+	email: optional(string$1())
 })]);
 var Funding = union([
-	string(),
+	string$1(),
 	object({
-		url: string(),
-		type: optional(string())
+		url: string$1(),
+		type: optional(string$1())
 	}),
-	array(union([string(), object({
-		url: string(),
-		type: optional(string())
+	array(union([string$1(), object({
+		url: string$1(),
+		type: optional(string$1())
 	})]))
 ]);
-var Person = union([string(), object({
-	name: string(),
-	email: optional(string()),
-	url: optional(string())
+var Person = union([string$1(), object({
+	name: string$1(),
+	email: optional(string$1()),
+	url: optional(string$1())
 })]);
-var Repository = union([string(), object({
-	type: string(),
-	url: string(),
-	directory: optional(string())
+var Repository = union([string$1(), object({
+	type: string$1(),
+	url: string$1(),
+	directory: optional(string$1())
 })]);
 var DevEngineDependency = object({
-	name: string(),
-	version: optional(string()),
+	name: string$1(),
+	version: optional(string$1()),
 	onFail: optional(literal([
 		"ignore",
 		"warn",
@@ -4051,57 +4080,57 @@ var DevEngines = object({
 	packageManager: optional(DevEngineDependencies)
 });
 var PackageJson = looseObject({
-	name: string(),
-	version: string(),
-	description: optional(string()),
-	keywords: optional(array(string())),
-	homepage: optional(string()),
+	name: string$1(),
+	version: string$1(),
+	description: optional(string$1()),
+	keywords: optional(array(string$1())),
+	homepage: optional(string$1()),
 	bugs: optional(Bugs),
-	license: optional(string()),
+	license: optional(string$1()),
 	author: optional(Person),
 	contributors: optional(array(Person)),
 	maintainers: optional(array(Person)),
 	funding: optional(Funding),
-	files: optional(array(string())),
+	files: optional(array(string$1())),
 	exports: optional(union([
 		_null(),
-		string(),
-		array(string()),
-		record(string(), unknown())
+		string$1(),
+		array(string$1()),
+		record(string$1(), unknown())
 	])),
 	type: optional(literal(["module", "commonjs"])),
-	main: optional(string()),
-	browser: optional(union([string(), record(string(), union([string(), boolean()]))])),
-	bin: optional(union([string(), record(string(), string())])),
-	man: optional(union([string(), array(string())])),
-	directories: optional(record(string(), string())),
+	main: optional(string$1()),
+	browser: optional(union([string$1(), record(string$1(), union([string$1(), boolean()]))])),
+	bin: optional(union([string$1(), record(string$1(), string$1())])),
+	man: optional(union([string$1(), array(string$1())])),
+	directories: optional(record(string$1(), string$1())),
 	repository: optional(Repository),
-	scripts: optional(record(string(), string())),
-	config: optional(record(string(), unknown())),
-	dependencies: optional(record(string(), string())),
-	devDependencies: optional(record(string(), string())),
-	peerDependencies: optional(record(string(), string())),
-	peerDependenciesMeta: optional(record(string(), object({ optional: boolean() }))),
-	bundleDependencies: optional(union([boolean(), array(string())])),
-	bundledDependencies: optional(union([boolean(), array(string())])),
-	optionalDependencies: optional(record(string(), string())),
-	overrides: optional(record(string(), unknown())),
-	engines: optional(record(string(), string())),
-	os: optional(array(string())),
-	cpu: optional(array(string())),
-	libc: optional(string()),
+	scripts: optional(record(string$1(), string$1())),
+	config: optional(record(string$1(), unknown())),
+	dependencies: optional(record(string$1(), string$1())),
+	devDependencies: optional(record(string$1(), string$1())),
+	peerDependencies: optional(record(string$1(), string$1())),
+	peerDependenciesMeta: optional(record(string$1(), object({ optional: boolean() }))),
+	bundleDependencies: optional(union([boolean(), array(string$1())])),
+	bundledDependencies: optional(union([boolean(), array(string$1())])),
+	optionalDependencies: optional(record(string$1(), string$1())),
+	overrides: optional(record(string$1(), unknown())),
+	engines: optional(record(string$1(), string$1())),
+	os: optional(array(string$1())),
+	cpu: optional(array(string$1())),
+	libc: optional(string$1()),
 	devEngines: optional(DevEngines),
 	private: optional(boolean()),
-	publishConfig: optional(record(string(), unknown())),
-	workspaces: optional(array(string())),
-	deprecated: optional(string()),
-	module: optional(string()),
-	types: optional(string()),
-	typings: optional(string()),
-	typesVersions: optional(record(string(), record(string(), array(string())))),
-	packageManager: optional(string()),
-	sideEffects: optional(union([boolean(), array(string())])),
-	imports: optional(record(string(), unknown()))
+	publishConfig: optional(record(string$1(), unknown())),
+	workspaces: optional(array(string$1())),
+	deprecated: optional(string$1()),
+	module: optional(string$1()),
+	types: optional(string$1()),
+	typings: optional(string$1()),
+	typesVersions: optional(record(string$1(), record(string$1(), array(string$1())))),
+	packageManager: optional(string$1()),
+	sideEffects: optional(union([boolean(), array(string$1())])),
+	imports: optional(record(string$1(), unknown()))
 });
 //#endregion
 //#region ../../node_modules/.pnpm/quick-lru@7.3.0/node_modules/quick-lru/index.js
@@ -4502,14 +4531,14 @@ function assertValidPackageName(name) {
 (e.g., `{ "latest": "1.0.0" }`).
 */
 var DistTags = object({
-	latest: string(),
-	next: string().optional(),
-	alpha: string().optional(),
-	beta: string().optional(),
-	rc: string().optional(),
-	canary: string().optional(),
-	dev: string().optional()
-}).catchall(string());
+	latest: string$1(),
+	next: string$1().optional(),
+	alpha: string$1().optional(),
+	beta: string$1().optional(),
+	rc: string$1().optional(),
+	canary: string$1().optional(),
+	dev: string$1().optional()
+}).catchall(string$1());
 //#endregion
 //#region ../../node_modules/.pnpm/query-registry@4.3.0_zod@4.3.6/node_modules/query-registry/dist/fetch-data.js
 async function fetchData(schema, url, headers) {
@@ -4534,36 +4563,36 @@ var npmRegistryUrl = "https://registry.npmjs.org";
 @see {@link https://github.com/npm/registry/blob/master/docs/responses/package-metadata.md#dist}
 */
 var Dist = object({
-	tarball: string(),
-	shasum: string(),
-	integrity: string().optional(),
+	tarball: string$1(),
+	shasum: string$1(),
+	integrity: string$1().optional(),
 	fileCount: number().optional(),
 	unpackedSize: number().optional(),
-	"npm-signature": string().optional(),
+	"npm-signature": string$1().optional(),
 	signatures: array(object({
-		keyid: string(),
-		sig: string()
+		keyid: string$1(),
+		sig: string$1()
 	})).optional()
 });
 var PackageManifest = object({
 	...PackageJson.shape,
-	_id: string(),
+	_id: string$1(),
 	dist: Dist,
-	readme: string().optional(),
-	readmeFilename: string().optional(),
-	gitHead: string().optional(),
+	readme: string$1().optional(),
+	readmeFilename: string$1().optional(),
+	gitHead: string$1().optional(),
 	_hasShrinkwrap: boolean().optional(),
-	_nodeVersion: string().optional(),
-	_npmVersion: string().optional(),
+	_nodeVersion: string$1().optional(),
+	_npmVersion: string$1().optional(),
 	_npmUser: PackageJson.shape.author.optional(),
 	_npmOperationalInternal: object({
-		host: string().optional(),
-		tmp: string().optional()
+		host: string$1().optional(),
+		tmp: string$1().optional()
 	}).optional(),
-	engines: record(string(), string()).optional().catch(void 0),
-	license: string().optional().catch(void 0),
-	homepage: string().optional().catch(void 0),
-	deprecated: union([string(), boolean()]).optional(),
+	engines: record(string$1(), string$1()).optional().catch(void 0),
+	license: string$1().optional().catch(void 0),
+	homepage: string$1().optional().catch(void 0),
+	deprecated: union([string$1(), boolean()]).optional(),
 	type: literal(["module", "commonjs"]).optional().catch(void 0)
 });
 /**
@@ -4582,10 +4611,10 @@ async function getPackageManifest(name, versionOrTag = "latest", registry = npmR
 //#endregion
 //#region ../../node_modules/.pnpm/query-registry@4.3.0_zod@4.3.6/node_modules/query-registry/dist/get-abbreviated-packument.js
 var AbbreviatedPackument = object({
-	name: string(),
-	modified: string(),
+	name: string$1(),
+	modified: string$1(),
 	"dist-tags": DistTags,
-	versions: record(string(), object({
+	versions: record(string$1(), object({
 		...PackageManifest.pick({
 			name: true,
 			version: true,
@@ -6848,28 +6877,19 @@ var require_pack = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	}
 }));
 //#endregion
-//#region src/config.ts
+//#region src/util/package.ts
 var import_tar_stream = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.extract = require_extract();
 	exports.pack = require_pack();
 })))(), 1);
-var { version: version$1 } = package_default;
-var USER_AGENT = `onyx-mcp/${version$1}`;
-var REGISTRY_URL = process.env.REGISTRY_URL ?? "https://registry.npmjs.org";
-/**
-* Minimum `sit-onyx` version that provides `vue-component-meta`
-*/
-var SIT_ONYX_MIN_VERSION = "1.12.0";
-//#endregion
-//#region src/util/component-meta-json.ts
 var SuccessfulAbort = class {
 	constructor(data) {
 		this.data = data;
 	}
 };
-async function retrieveComponentMetaJsonFile(version) {
-	const { dist } = await getPackageManifest("sit-onyx", version, REGISTRY_URL);
-	const { body } = await fetch(dist.tarball, { headers: { "User-Agent": USER_AGENT } });
+async function getSingleFileFromPackage(packageIdent, matcher, userAgent) {
+	const { dist } = await getPackageManifest(packageIdent.name, packageIdent.versionOrTag, packageIdent.registry);
+	const { body } = await fetch(dist.tarball, { headers: { "User-Agent": userAgent } });
 	if (!body) throw new Error(`No body in response for tarball request to "${dist.tarball}"!`);
 	/**
 	* Allows us to stop the stream pipeline at any time.
@@ -6878,26 +6898,23 @@ async function retrieveComponentMetaJsonFile(version) {
 	const abortController = new AbortController();
 	const archiveDownload = Readable.fromWeb(body);
 	const decompress = createGunzip();
-	const fileSearcher = createTarFileSearcher(abortController);
+	const fileSearcher = createTarFileSearcher(matcher, abortController);
 	try {
 		await pipeline(archiveDownload, decompress, fileSearcher, { signal: abortController.signal });
-		throw new Error("No 'component-meta.json' found!");
+		throw new Error("No matching file found!");
 	} catch (error) {
-		if (error instanceof Error && error.name === "AbortError" && error.cause instanceof SuccessfulAbort) {
-			const { data } = error.cause;
-			return JSON.parse(data.toString("utf-8"));
-		}
+		if (error instanceof Error && error.name === "AbortError" && error.cause instanceof SuccessfulAbort) return error.cause.data;
 		throw error;
 	}
 }
 /**
-* Returns a writable stream, which searches a file in a tar archive by filename/filepath.
+* Returns a writable stream, which searches a file in a tar archive.
 * If found, will call the AbortController with the file content as reason.
 */
-function createTarFileSearcher(abortController) {
+function createTarFileSearcher(matcher, abortController) {
 	const searchFile = import_tar_stream.extract();
 	searchFile.on("entry", async (headers, stream, next) => {
-		if (headers.name === "package/dist/component-meta.json") {
+		if (matcher(headers)) {
 			const data = await buffer(stream);
 			abortController.abort(new SuccessfulAbort(data));
 		} else {
@@ -6908,6 +6925,15 @@ function createTarFileSearcher(abortController) {
 	return searchFile;
 }
 //#endregion
+//#region src/util/component-meta-json.ts
+async function retrieveComponentMetaJsonFile(versionOrTag) {
+	const data = await getSingleFileFromPackage({
+		name: "sit-onyx",
+		versionOrTag
+	}, (header) => header.name === SIT_ONYX_COMPONENT_META_FILE, USER_AGENT);
+	return JSON.parse(data.toString("utf-8"));
+}
+//#endregion
 //#region src/resources/get-component-api.ts
 /**
 * Returns true if both parameters are defined and equal (ignoring surrounding whitespaces and case)
@@ -6919,7 +6945,7 @@ var getComponentApi = [
 	new ResourceTemplate("components://sit-onyx/{version}/{component}", { list: void 0 }),
 	{
 		title: "Get Component API",
-		description: "Get the component api for a specific component and version of onyx",
+		description: "Gets the component API for a specific component and version of onyx",
 		mimeType: "text/markdown"
 	},
 	async (uri, { version: _version, component: _component }) => {
@@ -7015,33 +7041,138 @@ var listComponents = [
 	}
 ];
 //#endregion
+//#region src/util/icons-metadata-json.ts
+async function retrieveIconsMetadataJsonFile(versionOrTag) {
+	const data = await getSingleFileFromPackage({
+		name: "@sit-onyx/icons",
+		versionOrTag
+	}, (header) => header.name === SIT_ONYX_ICONS_METADATA_FILE, USER_AGENT);
+	return JSON.parse(data.toString("utf-8"));
+}
+//#endregion
+//#region src/resources/list-icons.ts
+var listIcons = [
+	"list-icons",
+	new ResourceTemplate("icons://sit-onyx/{version}", { list: void 0 }),
+	{
+		title: "List @sit-onyx/icons icons",
+		description: "List all icons available in a specific version of @sit-onyx/icons",
+		mimeType: "text/markdown"
+	},
+	async (uri, { version: _version }) => {
+		const version = Array.isArray(_version) ? _version[0] : _version;
+		const iconsMetadata = await retrieveIconsMetadataJsonFile(version);
+		const categoryMap = /* @__PURE__ */ new Map();
+		Object.entries(iconsMetadata).forEach(([name, data]) => {
+			if (!categoryMap.has(data.category)) categoryMap.set(data.category, []);
+			categoryMap.get(data.category).push({
+				name,
+				...data
+			});
+		});
+		const text = `# Icons for \`@sit-onyx/icons@${version}\`
+
+This is a list of all icons offered by the \`@sit-onyx/icons@${version}\` package.
+The icons are grouped by category.
+
+${categoryMap.entries().toArray().toSorted(([a], [b]) => a.localeCompare(b)).map(([category, icons]) => {
+			return `## ${category}
+
+${icons.map(({ aliases, name }) => `- \`${name}\` (aliases: ${aliases.join(", ")})`).join("\n")}`;
+		}).join("\n\n")}`;
+		return { contents: [{
+			uri: uri.href,
+			text,
+			mimeType: "text/markdown"
+		}] };
+	}
+];
+//#endregion
+//#region ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/mini/schemas.js
+var ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
+	if (!inst._zod) throw new Error("Uninitialized schema in ZodMiniType.");
+	$ZodType.init(inst, def);
+	inst.def = def;
+	inst.type = def.type;
+	inst.parse = (data, params) => parse$1(inst, data, params, { callee: inst.parse });
+	inst.safeParse = (data, params) => safeParse$1(inst, data, params);
+	inst.parseAsync = async (data, params) => parseAsync$1(inst, data, params, { callee: inst.parseAsync });
+	inst.safeParseAsync = async (data, params) => safeParseAsync$1(inst, data, params);
+	inst.check = (...checks) => {
+		return inst.clone({
+			...def,
+			checks: [...def.checks ?? [], ...checks.map((ch) => typeof ch === "function" ? { _zod: {
+				check: ch,
+				def: { check: "custom" },
+				onattach: []
+			} } : ch)]
+		}, { parent: true });
+	};
+	inst.with = inst.check;
+	inst.clone = (_def, params) => clone(inst, _def, params);
+	inst.brand = () => inst;
+	inst.register = ((reg, meta) => {
+		reg.add(inst, meta);
+		return inst;
+	});
+	inst.apply = (fn) => fn(inst);
+});
+var ZodMiniString = /* @__PURE__ */ $constructor("ZodMiniString", (inst, def) => {
+	$ZodString.init(inst, def);
+	ZodMiniType.init(inst, def);
+});
+/* @__NO_SIDE_EFFECTS__ */
+function string(params) {
+	return /* @__PURE__ */ _string(ZodMiniString, params);
+}
+//#endregion
+//#region src/util/mcp-server.ts
+var resourceToTool = (resource) => {
+	const [name, template, { title, description }, cb] = resource;
+	const hasInputSchema = !!template.uriTemplate.variableNames.length;
+	return [
+		name,
+		{
+			title,
+			description,
+			inputSchema: hasInputSchema ? Object.fromEntries(template.uriTemplate.variableNames.map((v) => [v, /* @__PURE__ */ string()])) : void 0,
+			annotations: {
+				readOnlyHint: true,
+				destructiveHint: false,
+				idempotentHint: true
+			}
+		},
+		(async (...args) => {
+			const [vars, extra] = hasInputSchema ? args : [{}, args.at(0)];
+			const { contents } = await cb(new URL(template.uriTemplate.expand(vars)), vars, extra);
+			return { content: contents.map((resource) => ({
+				type: "resource",
+				resource
+			})) };
+		})
+	];
+};
+//#endregion
 //#region src/server/server.ts
 var { name, version, description } = package_default;
-/**
-* Internal McpServer, which provides the MCP resources.
-*/
-var server = new McpServer({
-	name,
-	version,
-	description,
-	websiteUrl: "https://onyx.schwarz"
-});
-server.registerResource(...listComponents);
-server.registerResource(...getComponentApi);
-//#endregion
-//#region src/server/http.ts
-/**
-* MCP server running as a http server.
-* `HOST` and `PORT` environment variable can be used to change the server settings.
-*/
-var run = async () => {
-	const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID() });
-	await server.connect(transport);
-	const httpServer = createServer(transport.handleRequest);
-	const PORT = Number.parseInt(process.env["PORT"] ?? "3000");
-	const HOST = process.env["HOST"] ?? "0.0.0.0";
-	httpServer.listen(PORT, HOST);
-	log(`MCP http server listening on ${HOST}:${PORT}.`);
+var resources = [
+	listComponents,
+	getComponentApi,
+	listIcons
+];
+var createServer = ({ resourcesAsTools }) => {
+	/**
+	* Internal McpServer, which provides the MCP resources.
+	*/
+	const server = new McpServer({
+		name,
+		version,
+		description,
+		websiteUrl: "https://onyx.schwarz"
+	});
+	resources.forEach((resource) => server.registerResource(...resource));
+	if (resourcesAsTools) resources.map((r) => resourceToTool(r)).forEach((t) => server.registerTool(...t));
+	return server;
 };
 //#endregion
 //#region src/server/stdio.ts
@@ -7049,7 +7180,7 @@ var run = async () => {
 * MCP server running via stdio.
 * All logging has to use stderr, otherwise the logging to stdio will break the transport.
 */
-var run$1 = async () => {
+var run$1 = async (server) => {
 	const transport = new StdioServerTransport();
 	await server.connect(transport);
 	error("MCP Server running on stdio.");
@@ -7061,7 +7192,7 @@ var SUPPORTED_TRANSPORTS = {
 	http: run
 };
 if (import.meta.main) {
-	const { values: { transport, version, help } } = parseArgs({
+	const { values: { transport, version, help, resourcesAsTools } } = parseArgs({
 		args: process.argv.slice(2),
 		options: {
 			transport: {
@@ -7069,6 +7200,11 @@ if (import.meta.main) {
 				short: "t",
 				default: "stdio"
 			},
+			resourcesAsTools: {
+				type: "boolean",
+				short: "r",
+				default: false
+			},
 			help: {
 				type: "boolean",
 				short: "h",
@@ -7091,17 +7227,20 @@ Usage:
     onyx-mcp [options]
 
 Options:
- -t, --transport <stdio|http> Which kind of MCP server should be started (default: stdio)
- -h, --help                   This help text
- -v, --version                Show version number and quit`);
+ -t, --transport <stdio|http> Which kind of MCP server should be started (default: stdio).
+ -r, --resourcesAsTools       Some LLM Coding Assistants (e.g. Gemini) are not able to to use MCP resources (yet). 
+                              This setting makes resources also available as tools to support these Coding Assistants.
+ -h, --help                   Show this help text and quit.
+ -v, --version                Show version number and quit.`);
 		process.exit(0);
 	} else if (version) {
 		log(package_default.version);
 		process.exit(0);
 	} else {
 		if (!Object.keys(SUPPORTED_TRANSPORTS).includes(transport)) throw new Error(`Unsupported transport: ${transport}`);
-		await SUPPORTED_TRANSPORTS[transport]();
+		const server = createServer({ resourcesAsTools });
+		await SUPPORTED_TRANSPORTS[transport](server);
 	}
 }
 //#endregion
-export { run as http, server, run$1 as stdio };
+export { createServer, run as http, run$1 as stdio };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sit-onyx/modelcontextprotocol",
-  "version": "0.1.0-dev-20260409103041",
+  "version": "0.1.0-dev-20260410085526",
   "description": "MCP (Model Context Protocol) Server that provide onyx specific tools and resources.",
   "homepage": "https://onyx.schwarz",
   "bugs": {
@@ -34,6 +34,7 @@
     "vite": "8.0.5",
     "vite-plugin-dts": "^4.5.4",
     "vue-component-meta": "^3.2.6",
+    "zod": "^4.3.6",
     "@sit-onyx/shared": "^0.1.0"
   },
   "engines": {
@@ -42,7 +43,7 @@
   "scripts": {
     "dev": "pnpm run \"/build-dev|inspect-mcp/\"",
     "build-dev": "vite build --ssr -w",
-    "inspect-mcp": "pnpm dlx @modelcontextprotocol/inspector node ./dist/index.js",
+    "inspect-mcp": "pnpm dlx @modelcontextprotocol/inspector --config inspector.json",
     "build": "vite build --ssr"
   }
 }