@mcp-rune/create 0.11.0

package/templates/simple/package.json.ejs

@@ -0,0 +1,27 @@
+{
+  "name": "<%= projectName %>",
+  "version": "0.1.0",
+  "description": "MCP server scaffolded with @mcp-rune/create",
+  "type": "module",
+  "private": true,
+  "engines": {
+    "node": "<%= nodeEngine %>"
+  },
+  "scripts": {
+    "start": "tsx src/server.ts",
+    "start:local": "tsx src/server.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "inspect": "mcp-rune inspect"
+  },
+  "dependencies": {
+    "@mcp-rune/mcp-rune": "<%= mcpRuneVersion %>"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.22.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.7"
+  }
+}

package/templates/simple/src/config.ts.ejs

@@ -0,0 +1,56 @@
+import type { ApiClient } from '@mcp-rune/mcp-rune/core'
+import { createServer } from '@mcp-rune/mcp-rune/server'
+import {
+  DATA_TOOL_CLASSES,
+  FORM_STRATEGY_TOOL_CLASSES,
+  ToolRegistry
+} from '@mcp-rune/mcp-rune/tools'
+
+import { MODEL_CLASSES } from './models/index.js'
+import { promptRegistry } from './prompts/index.js'
+
+// Stub ApiClient — replace with your real HTTP client. The Proxy surfaces a
+// clear error if any tool accidentally tries to hit the network before you
+// have one wired up.
+const stubApiClient = new Proxy({} as ApiClient, {
+  get() {
+    throw new Error(
+      'No ApiClient configured. Wire `createApiClient` in src/config.ts before using auth-gated tools.'
+    )
+  }
+})
+
+const toolRegistry = new ToolRegistry({
+  toolClasses: { ...DATA_TOOL_CLASSES, ...FORM_STRATEGY_TOOL_CLASSES },
+  models: MODEL_CLASSES,
+  serverContext: {
+    name: '<%= projectNamePascal %>'
+  },
+  namespace: '<%= projectName %>',
+  promptRegistry,
+  createApiClient: () => stubApiClient
+})
+
+export const mcpConfig = {
+  name: '<%= projectName %>',
+
+  createServer({
+    sessionId,
+    transport,
+    getAccessToken
+  }: {
+    sessionId: string
+    transport: string
+    getAccessToken: () => Promise<string>
+  }) {
+    return createServer({
+      name: '<%= projectName %>',
+      version: '0.1.0',
+      sessionId,
+      transport,
+      toolRegistry,
+      promptRegistry,
+      getAccessToken
+    })
+  }
+}

package/templates/simple/src/models/_model_.ts.ejs

@@ -0,0 +1,25 @@
+import type { AttributeDefinition } from '@mcp-rune/mcp-rune/models'
+import { BaseModel } from '@mcp-rune/mcp-rune/models'
+
+export class <%= model.namePascal %> extends BaseModel {
+  static override description = '<%= model.description || `A ${model.name} record` %>'
+  static override api = { endpoint: '<%= model.endpoint || `${model.fileName}s` %>' }
+
+  static override attributes: Record<string, AttributeDefinition> = {
+<% for (const attr of model.attributes) { -%>
+    <%= attr.name %>: {
+      type: '<%= attr.type %>',
+<% if (attr.required) { -%>
+      required: true,
+<% } -%>
+<% if (attr.description) { -%>
+      description: '<%= attr.description %>',
+<% } -%>
+    },
+<% } -%>
+  }
+
+  static get attributesConfig(): Record<string, AttributeDefinition> {
+    return this.attributes
+  }
+}

package/templates/simple/src/models/index.ts.ejs

@@ -0,0 +1,13 @@
+<% for (const m of models) { -%>
+import { <%= m.namePascal %> } from './<%= m.fileName %>.js'
+<% } -%>
+
+export const MODEL_CLASSES = {
+<% for (const m of models) { -%>
+  <%= m.fileName %>: <%= m.namePascal %>,
+<% } -%>
+}
+
+<% for (const m of models) { -%>
+export { <%= m.namePascal %> }
+<% } -%>

package/templates/simple/src/prompts/_model_-prompt.ts.ejs

@@ -0,0 +1,27 @@
+import {
+  BasePrompt,
+  derivePromptSchema,
+  PromptContentBuilder
+} from '@mcp-rune/mcp-rune/prompts'
+import type { FormStrategyType } from '@mcp-rune/mcp-rune/prompts'
+
+import { <%= model.namePascal %> } from '../models/<%= model.fileName %>.js'
+
+export class <%= model.namePascal %>Prompt extends BasePrompt {
+  static override formStrategy: FormStrategyType = 'hybrid'
+
+  static {
+    const schema = derivePromptSchema(<%= model.namePascal %>)
+    this.fieldGroups = schema.fieldGroups
+    this.fieldDefinitions = schema.fieldDefinitions
+  }
+
+  override get promptContent(): string {
+    return PromptContentBuilder.for(<%= model.namePascal %>Prompt, '<%= model.fileName %>')
+      .add('# <%= model.namePascal %> guide')
+      .standard()
+      .toolUsage()
+      .attributeReference()
+      .build()
+  }
+}

package/templates/simple/src/prompts/index.ts.ejs

@@ -0,0 +1,18 @@
+import { BasePromptRegistry } from '@mcp-rune/mcp-rune/prompts'
+
+<% for (const m of models) { -%>
+import { <%= m.namePascal %> } from '../models/<%= m.fileName %>.js'
+<% } -%>
+<% for (const m of models) { -%>
+import { <%= m.namePascal %>Prompt } from './<%= m.fileName %>-prompt.js'
+<% } -%>
+
+export const promptRegistry = new BasePromptRegistry()
+
+<% for (const m of models) { -%>
+promptRegistry.register('<%= m.fileName %>', <%= m.namePascal %>Prompt, {
+  description: <%= m.namePascal %>.description,
+  required: true,
+  model: '<%= m.fileName %>'
+})
+<% } -%>

package/templates/simple/src/server.ts

@@ -0,0 +1,12 @@
+import { StdioServer } from '@mcp-rune/mcp-rune/server'
+
+import { mcpConfig } from './config.js'
+
+const ACCESS_TOKEN = process.env.ACCESS_TOKEN ?? 'demo-token'
+
+const server = new StdioServer({
+  accessToken: ACCESS_TOKEN,
+  mcp: mcpConfig
+})
+
+server.start()

package/templates/simple/test/smoke.test.ts

@@ -0,0 +1,16 @@
+import { readFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { describe, expect, it } from 'vitest'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+
+describe('scaffold smoke', () => {
+  it('package.json declares the design-mandated scripts', async () => {
+    const pkg = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'))
+    for (const name of ['start', 'start:local', 'test', 'typecheck', 'inspect']) {
+      expect(pkg.scripts[name], `missing script: ${name}`).toBeTypeOf('string')
+    }
+  })
+})

package/templates/simple/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*.ts", "test/**/*.ts"]
+}