I made Vovk.ts: Next.js route handlers that are also MCP tools, a typed client and OpenAPI

import { get, operation, post, prefix, procedure } from 'vovk';
import { z } from 'zod';

const TaskSchema = z.object({ id: z.string(), title: z.string(), done: z.boolean() });
const tasks: z.infer<typeof TaskSchema>[] = [];

@prefix('tasks')
export default class TaskController {
  @operation({ summary: 'List tasks', description: 'Returns every task.' })
  @get()
  static listTasks = procedure({ output: TaskSchema.array() }).handle(() => tasks);

  @operation({ summary: 'Create task', description: 'Creates a task with the given title.' })
  @post()
  static createTask = procedure({
    body: z.object({ title: z.string().min(1).describe('What needs doing') }),
    output: TaskSchema,
  }).handle(async (req) => {
    const task = { id: crypto.randomUUID(), title: (await req.vovk.body()).title, done: false };
    tasks.push(task);
    return task;
  });
}

// app/api/mcp/route.ts
import { createMcpHandler, McpServer } from '@modelcontextprotocol/server';
import { deriveTools, ToModelOutput } from 'vovk';
import TaskController from '@/modules/task/task-controller';

const tools = deriveTools({ modules: { TaskController }, toModelOutput: ToModelOutput.MCP });

const mcp = createMcpHandler(() => {
  const server = new McpServer({ name: 'my-app', version: '1.0.0' });
  tools.forEach(({ title, name, execute, description, inputSchema }) => {
    server.registerTool(name, { title, description, inputSchema }, execute);
  });
  return server;
});

const handler = (req: Request) => mcp.fetch(req);

export { handler as GET, handler as POST };