@sit-onyx/modelcontextprotocol 0.1.0-dev-20260409100058 → 0.1.0-dev-20260409155058

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,26 @@ 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}.`);
+};
 Object.freeze({ status: "aborted" });
 function $constructor(name, initializer, params) {
 	function init(inst, def) {
@@ -522,6 +538,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 +553,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 +666,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}$`);
 };
@@ -1146,7 +1164,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 +3547,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 +4026,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 +4069,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 +4520,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 +4552,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 +4600,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,
@@ -6919,7 +6937,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 +7033,87 @@ var listComponents = [
 	}
 ];
 //#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];
+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 +7121,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 +7133,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 +7141,11 @@ if (import.meta.main) {
 				short: "t",
 				default: "stdio"
 			},
+			resourcesAsTools: {
+				type: "boolean",
+				short: "r",
+				default: false
+			},
 			help: {
 				type: "boolean",
 				short: "h",
@@ -7091,17 +7168,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-20260409100058",
+  "version": "0.1.0-dev-20260409155058",
   "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"
   }
 }