convez.ai
MCP ServerDesenvolvimento WebIntermediário
agentfront

FrontMCP

agentfront/frontmcp

Framework TypeScript para MCP servers com decoradores, DI e auth integrados

Ver no GitHub
Muito bomPluginScore · de 0 a 100

Framework TypeScript de produção para construir servidores MCP com decoradores, injeção de dependência, autenticação e transporte HTTP. Oferece experiência totalmente tipada com Zod, executando o mesmo servidor em ambientes locais e produção sem mudanças.

Instalação

$npx convez-ai agentfront/frontmcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
153
Forks
8
Acompanhando
0
Saúde
100%
Último commit
há 4 dias
Versão
v1.12.2
Issues abertas
26
Contribuidores
6

Casos de uso

  • Construir servidores MCP tipados e escaláveis
  • Implantar em Node, Lambda, Vercel ou Workers com um único codebase
  • Implementar autenticação OAuth/JWKS com sessões stateful/stateless

Veredito

FrontMCP é um framework maduro e robusto para o ecossistema MCP, focado em experiência de desenvolvedor com segurança e tipagem fortes desde o início. Ideal para quem quer transportar lógica MCP para produção sem reescrever código.

README

A tradução para o português deste README ainda está na fila.

The production-grade, TypeScript-first framework for building MCP servers — decorators, DI, auth, and Streamable HTTP, batteries included.

NPM - @frontmcp/sdk Node License Snyk

Docs • Quickstart • API Reference • Discord


FrontMCP turns the Model Context Protocol into a typed, declarative framework. You write clean @Tool, @Resource, and @App classes; FrontMCP handles the protocol, transport, dependency injection, sessions, auth, and execution flow — and the same server runs locally and ships to production unchanged.

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

Why FrontMCP

  • Typed by default — decorators + Zod schemas give end-to-end types from input to output, with editor autocomplete and compile-time checks.
  • Batteries included — auth (OAuth/JWKS/DCR), sessions, transport, discovery, and DI are built in, not bolted on.
  • Ship anywhere — one codebase deploys to Node, Vercel, AWS Lambda, Cloudflare Workers, or a serverless bundle.
  • Production-minded — stateful/stateless sessions, high-availability transport, structured observability, and a 95%+ tested core.
  • Extensible — plugins, lifecycle hooks, OpenAPI adapters, and external MCP sub-apps when you outgrow the defaults.

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 · Quickstart

Capabilities

Build — decorator-configured @FrontMcp server and @App domains; typed @Tool, @Resource, and @Prompt primitives; @Agent multi-step chains; and scoped Providers / DI.

Secure — Remote & Local OAuth, JWKS, DCR, per-app auth with stateful / stateless sessions (JWT or UUID transport IDs).

Connect & operate — Streamable HTTP + SSE transport, capability discovery, elicitation, hooks, HTTP-discoverable skills, external MCP sub-apps, an in-process Direct Client (connectOpenAI / connectClaude), and first-class deployment.

Extend & tooling — official plugins (Cache, Remember, CodeCall, Dashboard), the OpenAPI adapter, a UI library (HTML/React widgets, SSR, MCP Bridge), an E2E testing framework, and a CLI (create, init, dev, build, inspect, doctor).

→ Full reference: docs.agentfront.dev/frontmcp

Packages

PackageDescription
@frontmcp/sdkCore framework — decorators, DI, flows, transport
@frontmcp/cliCLI tooling (frontmcp create, dev, build)
@frontmcp/authAuthentication, OAuth, JWKS, credential vault
@frontmcp/adaptersOpenAPI adapter for auto-generating tools
@frontmcp/pluginsOfficial plugins: Cache, Remember, CodeCall, Dashboard
@frontmcp/testingE2E test framework with fixtures and matchers
@frontmcp/uiReact components, hooks, SSR renderers
@frontmcp/uipackReact-free themes, build tools, platform adapters
@frontmcp/diDependency injection container (internal)
@frontmcp/utilsShared 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

Ver o original no GitHub

Bom para

Relacionados