feat: setup cli project

packages/mcp-server/src/mcp/autofixers/visitors/assign-in-effect.ts

@@ -1,10 +1,14 @@
 import type { AssignmentExpression, Identifier, Node, UpdateExpression } from 'estree';
-import type { Autofixer, AutofixerState } from '.';
+import type { Autofixer, AutofixerState } from './index.js';
 import { left_most_id } from '../ast/utils.js';
-import type { SvelteNode } from 'svelte-eslint-parser/lib/ast';
+import type { AST } from 'svelte-eslint-parser';
 import type { Context } from 'zimmerframe';
 
-function run_if_in_effect(path: (Node | SvelteNode)[], state: AutofixerState, to_run: () => void) {
+function run_if_in_effect(
+	path: (Node | AST.SvelteNode)[],
+	state: AutofixerState,
+	to_run: () => void,
+) {
 	const in_effect = path.findLast(
 		(node) =>
 			node.type === 'CallExpression' &&
@@ -25,7 +29,7 @@ function run_if_in_effect(path: (Node | SvelteNode)[], state: AutofixerState, to
 
 function visitor(
 	node: UpdateExpression | AssignmentExpression,
-	{ state, path }: Context<Node | SvelteNode, AutofixerState>,
+	{ state, path }: Context<Node | AST.SvelteNode, AutofixerState>,
 ) {
 	run_if_in_effect(path, state, () => {
 		function check_if_stateful_id(id: Identifier) {

packages/mcp-server/src/mcp/autofixers/visitors/derived-with-function.ts

@@ -1,29 +1,29 @@
 import type { Identifier, PrivateIdentifier } from 'estree';
-import type { Autofixer } from '.';
+import type { Autofixer } from './index.js';
 
 export const derived_with_function: Autofixer = {
 	CallExpression(node, { state, path }) {
 		if (
 			node.callee.type === 'Identifier' &&
 			node.callee.name === '$derived' &&
 			state.parsed.is_rune(node, ['$derived']) &&
-			(node.arguments[0].type === 'ArrowFunctionExpression' ||
-				node.arguments[0].type === 'FunctionExpression')
+			(node.arguments[0]?.type === 'ArrowFunctionExpression' ||
+				node.arguments[0]?.type === 'FunctionExpression')
 		) {
 			const parent = path[path.length - 1];
 			let variable_id: Identifier | PrivateIdentifier | undefined;
-			if (parent.type === 'VariableDeclarator' && parent.id.type === 'Identifier') {
+			if (parent?.type === 'VariableDeclarator' && parent.id.type === 'Identifier') {
 				// const something = $derived(...)
 				variable_id = parent.id;
-			} else if (parent.type === 'PropertyDefinition') {
+			} else if (parent?.type === 'PropertyDefinition') {
 				// class X { something = $derived(...) }
 				variable_id =
 					parent.key.type === 'Identifier'
 						? parent.key
 						: parent.key.type === 'PrivateIdentifier'
 							? parent.key
 							: undefined;
-			} else if (parent.type === 'AssignmentExpression') {
+			} else if (parent?.type === 'AssignmentExpression') {
 				// this.something = $derived(...)
 				variable_id =
 					parent.left.type === 'MemberExpression'

packages/mcp-server/src/mcp/autofixers/visitors/imported-runes.ts

@@ -1,5 +1,5 @@
 import { base_runes } from '../../../constants.js';
-import type { Autofixer } from '.';
+import type { Autofixer } from './index.js';
 
 const dollarless_runes = base_runes.map((r) => r.replace('$', ''));
 

packages/mcp-server/src/mcp/autofixers/visitors/set-or-update-state.ts

@@ -1,4 +1,4 @@
-import type { Autofixer } from '.';
+import type { Autofixer } from './index.js';
 import { left_most_id } from '../ast/utils.js';
 
 const UPDATE_PROPERTIES = ['set', 'update'];
@@ -7,7 +7,7 @@ export const set_or_update_state: Autofixer = {
 	MemberExpression(node, { state, next, path }) {
 		const parent = path[path.length - 1];
 		if (
-			parent.type === 'CallExpression' &&
+			parent?.type === 'CallExpression' &&
 			parent.callee === node &&
 			node.property.type === 'Identifier' &&
 			UPDATE_PROPERTIES.includes(node.property.name)

packages/mcp-server/src/mcp/autofixers/visitors/use-runes-instead-of-store.ts

@@ -1,4 +1,4 @@
-import type { Autofixer } from '.';
+import type { Autofixer } from './index.js';
 
 export const use_runes_instead_of_store: Autofixer = {
 	ImportDeclaration(node, { state, next }) {

packages/mcp-server/src/mcp/handlers/tools/playground-link.ts

@@ -13,7 +13,7 @@ async function compress_and_encode_text(input: string) {
 		} else {
 			for (let i = 0; i < value.length; i++) {
 				// decoding as utf-8 will make btoa reject the string
-				buffer += String.fromCharCode(value[i]);
+				buffer += String.fromCharCode(value[i]!);
 			}
 		}
 	}

packages/mcp-stdio/README.md

@@ -0,0 +1,16 @@
+# @sveltejs/mcp
+
+The CLI version of the Svelte MCP.
+
+You can run it directly with
+
+```bash
+npx @sveltejs/mcp
+```
+
+or install it and then run it
+
+```bash
+pnpm i @sveltejs/mcp
+pnpm svelte-mcp
+```

packages/mcp-stdio/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "@sveltejs/mcp",
+	"version": "0.0.1",
+	"type": "module",
+	"license": "MIT",
+	"homepage": "https://github.com/sveltejs/mcp#readme",
+	"bugs": {
+		"url": "https://github.com/sveltejs/mcp/issues"
+	},
+	"bin": {
+		"svelte-mcp": "./dist/index.js"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/sveltejs/mcp.git"
+	},
+	"author": "Author Name <[email protected]>",
+	"files": [
+		"dist"
+	],
+	"main": "./dist/index.js",
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"dev": "tsdown --watch",
+		"test": "vitest",
+		"check": "tsc --noEmit"
+	},
+	"devDependencies": {
+		"@sveltejs/mcp-server": "workspace:^",
+		"@tmcp/transport-stdio": "^0.3.0",
+		"@types/node": "^22.15.17",
+		"publint": "^0.3.13",
+		"tsdown": "^0.11.9",
+		"typescript": "^5.8.3",
+		"vitest": "^3.1.3"
+	},
+	"dependencies": {
+		"eslint": "^9.36.0"
+	}
+}

packages/mcp-stdio/src/index.ts

@@ -0,0 +1,7 @@
+#! /usr/bin/env node
+import { server } from '@sveltejs/mcp-server';
+import { StdioTransport } from '@tmcp/transport-stdio';
+
+const transport = new StdioTransport(server);
+
+transport.listen();

packages/mcp-stdio/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"include": ["src"],
+	"exclude": ["node_modules", "dist"]
+}

packages/mcp-stdio/tsdown.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig([
+	{
+		entry: ['./src/index.ts'],
+		platform: 'node',
+		define: {
+			// some eslint-plugin-svelte code expects __filename to exists but in an ESM environment it does not.
+			__filename: '""',
+		},
+		// we need eslint at runtime but the bundler doesn't bundle `require`'s which `eslint-plugin-svelte` uses to require
+		// `eslint/use-at-your-own-risk`. If we didn't have `eslint` as an actual dependency and didn't externalize it
+		// the require would fail once executed in a project without eslint installed.
+		external: ['eslint'],
+		publint: true,
+		dts: false,
+		treeshake: true,
+		clean: true,
+		target: 'esnext',
+	},
+]);

packages/mcp-stdio/vitest.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({});