The TypeScript way to build MCP servers with decorators, DI, and Streamable HTTP.

Docs • Quickstart • API Reference • Discord

FrontMCP is a TypeScript-first framework for the Model Context Protocol (MCP).
You write clean, typed code; FrontMCP handles the protocol, transport, DI, session/auth, and execution flow.

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 {}

Installation

Node.js 24+ required.

# New project (recommended)
npx frontmcp create my-app

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

Full setup guide: Installation

Capabilities

Capability	Description	Docs
@FrontMcp Server	Decorator-configured server with info, apps, HTTP, logging, session, auth	Server
@App	Organizational units grouping tools, resources, prompts with optional isolation	Apps
@Tool	Typed actions with Zod schemas — class or function style	Tools
@Resource	Read-only data exposure with static and template URIs	Resources
@Prompt	Reusable message templates returning `GetPromptResult`	Prompts
@Agent	Orchestrated multi-step tool chains	Agents
Elicitation	Request structured user input mid-flow	Elicitation
Skills	HTTP-discoverable tool manifests for agent marketplaces	Skills
Discovery	Automatic capability advertisement for MCP clients	Discovery
Authentication	Remote OAuth, Local OAuth, JWKS, DCR, per-app auth	Authentication
Sessions	Stateful/stateless session modes with JWT or UUID transport IDs	Server
Direct Client	In-process `create()`, `connect()`, `connectOpenAI()`, `connectClaude()`	Direct Client
Transport	Streamable HTTP + SSE with session headers	Transport
Ext-Apps	Mount external MCP servers as sub-apps	Ext-Apps
Hooks	5 hook families: tool, list-tools, HTTP, resource, prompt	Hooks
Providers / DI	Scoped dependency injection with GLOBAL and CONTEXT scopes	Providers
Plugins	Cache, Remember, CodeCall, Dashboard — or build your own	Plugins
Adapters	Generate tools from OpenAPI specs	Adapters
Testing	E2E fixtures, matchers, HTTP mocking for MCP servers	Testing
UI Library	HTML/React widgets, SSR, MCP Bridge, web components	UI
CLI	`create`, `init`, `dev`, `build`, `inspector`, `doctor`	CLI
Deployment	Local dev, production builds, version alignment	Deployment

Packages

Package	Description
`@frontmcp/sdk`	Core framework — decorators, DI, flows, transport
`@frontmcp/cli`	CLI tooling (`frontmcp create`, `dev`, `build`)
`@frontmcp/auth`	Authentication, OAuth, JWKS, credential vault
`@frontmcp/adapters`	OpenAPI adapter for auto-generating tools
`@frontmcp/plugins`	Official plugins: Cache, Remember, CodeCall, Dashboard
`@frontmcp/testing`	E2E test framework with fixtures and matchers
`@frontmcp/ui`	React components, hooks, SSR renderers
`@frontmcp/uipack`	React-free themes, build tools, platform adapters
`@frontmcp/di`	Dependency injection container (internal)
`@frontmcp/utils`	Shared utilities — naming, URI, crypto, FS (internal)

Version Alignment

Keep all @frontmcp/* packages on the same version. A clear "version mismatch" error is thrown at boot if versions drift. (Production Build)

Contributing

PRs welcome! See CONTRIBUTING.md for workflow, coding standards, and the PR checklist.

License

Apache-2.0