FrontMCP

Use the official CLI scaffolder to create a fully configured project with TypeScript, decorators, and the core SDK already wired up.

npx frontmcp create my-mcp-app

If you already have a Node.js project, add the FrontMCP SDK and Node types as dev dependencies, then run the init command to generate the server entry point and tsconfig adjustments.

npm i -D frontmcp @types/node@^24
npx frontmcp init

Create an App class with the @App decorator and add methods decorated with @Tool. Each method receives typed, Zod-validated inputs and returns typed outputs automatically surfaced to MCP clients.

import 'reflect-metadata';
import { App, Tool } from '@frontmcp/sdk';
import { z } from 'zod';

@App({ name: 'hello' })
export default class HelloApp {
  @Tool({ description: 'Say hello to a name' })
  async greet({ name }: { name: z.infer<typeof z.string()> }) {
    return { message: `Hello, ${name}!` };
  }
}

Wire your App into the @FrontMcp decorator on the root server class. Set the HTTP port for local development.

import 'reflect-metadata';
import { FrontMcp, LogLevel } from '@frontmcp/sdk';
import HelloApp from './hello.app';

@FrontMcp({
  info: { name: 'Demo', version: '0.1.0' },
  apps: [HelloApp],
  http: { port: 3000 },
  logging: { level: LogLevel.Info },
})
export default class Server {}

Use the CLI dev command which watches for changes and restarts automatically. Alternatively build and run for production.

npx frontmcp dev
# or build for production:
npx frontmcp build && node dist/index.js

Configure your MCP client (Claude Desktop, Cursor, etc.) to connect to the local Streamable HTTP endpoint exposed by FrontMCP.