Permite construir MCP servers con TypeScript utilizando herramientas tipadas, inyección de dependencias, autenticación, pruebas y despliegue en Node, Vercel, Lambda o Workers.
También conocido como agentfront/frontmcp, @frontmcp/adapters, @frontmcp/auth, @frontmcp/edge, @frontmcp/guard
- Stars
- 152
- Herramientas
- —
- Descargas, 30 días
- 220.205
- Última versión
- —
- Último commit
- 14 nov 2026
- Licencia
- Apache-2.0
¿Qué es FrontMCP MCP?
FrontMCP es un MCP server. Permite construir MCP servers con TypeScript utilizando herramientas tipadas, inyección de dependencias, autenticación, pruebas y despliegue en Node, Vercel, Lambda o Workers.
Resumen generado a partir del README del proyecto
Acerca del MCP server de FrontMCP
La función principal de este framework es la construcción de MCP servers con TypeScript listos para producción. Permite a los desarrolladores definir herramientas, recursos y prompts mediante clases tipadas y esquemas de Zod, que luego se sirven a través del Model Context Protocol. El sistema gestiona requisitos complejos como la inyección de dependencias, la autenticación y el flujo de ejecución, garantizando que el mismo código funcione en una máquina local o en un entorno de producción sin necesidad de modificaciones.
Los desarrolladores pueden desplegar sus servidores en diversos entornos, incluyendo Node, Vercel, AWS Lambda o Cloudflare Workers. El ecosistema incluye paquetes especializados para funciones avanzadas como OAuth, limitación de tasa (rate limiting) con guard y observabilidad estructurada. Es compatible tanto con la revisión stateless del 2026-07-28 como con versiones anteriores del protocolo, lo que lo convierte en una opción versátil para crear herramientas agénticas escalables.
Qué puedes hacer con él
- 1Generar un nuevo proyectoUn desarrollador puede inicializar rápidamente un nuevo proyecto de MCP server utilizando la interfaz de línea de comandos.
- 2Crear herramientas tipadasPuedes definir herramientas matemáticas o lógicas utilizando clases de TypeScript y Zod para la validación de entradas.
- 3Desplegar en funciones edgeEl framework permite ejecutar servidores en entornos edge ligeros como Cloudflare Workers.
- 4Implementar aprobación humanaLos desarrolladores pueden añadir controles que requieren que una persona apruebe la ejecución de una herramienta antes de que se ejecute.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar FrontMCP MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar FrontMCP MCP en Claude Code
$ claude mcp add frontmcp -- npx -y @frontmcp/adaptersInstalar FrontMCP MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}Instalar FrontMCP MCP en VS Code
.vscode/mcp.json
{
"servers": {
"frontmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}Instalar FrontMCP MCP en VS Code CLI
$ code --add-mcp '{"name":"frontmcp","type":"stdio","command":"npx","args":["-y","@frontmcp/adapters"]}'Instalar FrontMCP MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}Instalar FrontMCP MCP en Codex
$ codex mcp add frontmcp -- npx -y @frontmcp/adaptersInstalar FrontMCP MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.frontmcp] command = "npx" args = ["-y", "@frontmcp/adapters"]
Instalar FrontMCP MCP en Gemini CLI
$ gemini mcp add -s user frontmcp npx -- -y @frontmcp/adaptersInstalar FrontMCP MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasNo verificado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
README
Ver en GitHubfrontmcp.dev · Learn · Reference · Examples · Playground · Compare · Blog
FrontMCP is the TypeScript framework for MCP servers. You write tools, resources and prompts as typed classes with Zod schemas, and FrontMCP serves them over the Model Context Protocol, with dependency injection, authentication, testing, agents and jobs, on Node, Vercel, AWS Lambda and Cloudflare Workers. It serves MCP 2026-07-28, the stateless revision, and the earlier ones. The docs, examples and a browser playground are at frontmcp.dev.
Write a tool. Ship a server.
Classes in, protocol out. FrontMCP handles transport, DI, sessions, auth and execution flow, and the same server runs locally and in production unchanged.
import 'reflect-metadata';
import { App, FrontMcp, Tool, ToolContext, z } from '@frontmcp/sdk';
@Tool({
name: 'add',
description: 'Adds two numbers together',
inputSchema: { a: z.number(), b: z.number() },
})
class AddTool extends ToolContext {
async execute(input: { a: number; b: number }) {
return input.a + input.b;
}
}
@App({ id: 'calc', name: 'Calculator', tools: [AddTool] })
class CalcApp {}
@FrontMcp({
info: { name: 'Demo', version: '0.1.0' },
apps: [CalcApp],
http: { port: 3000 },
})
export default class Server {}
Start
npx frontmcp create my-app # new project (Node 24+)
npx frontmcp init # or add FrontMCP to an existing one
Then follow Learn on frontmcp.dev, or browse Tools, Resources, Prompts, Agents, Auth, Plugins, Tool UI, Testing and Deployment. Try it live in the Playground.
How it compares
TypeScript MCP server frameworks for production puts FrontMCP next to the official TypeScript SDK, FastMCP for TypeScript, Prefect's FastMCP TypeScript, mcp-framework, mcp-use, ViteMCP and xmcp, on auth, testing, protocol support and deployment. Each library's hello world was run and asked which MCP revisions it serves. Why FrontMCP says when the official SDK alone is enough, and The Best TypeScript MCP Server Frameworks in 2026 sums up the field. Moving a server over? See Migrate from the TypeScript SDK and Migrate from FastMCP.
Packages
Install frontmcp (CLI) and @frontmcp/sdk. The rest is pulled in for you, or opt-in. Keep every @frontmcp/* package on the same version: they depend on each other at exact versions.
| Package | What it does |
|---|---|
frontmcp |
CLI: create, init, dev, build, test, inspector |
@frontmcp/sdk |
Core framework: decorators, DI, flows, transport, MCP protocol |
@frontmcp/auth |
OAuth, JWKS, DCR/CIMD, sessions, credential vault |
@frontmcp/testing |
E2E test framework with fixtures and matchers |
@frontmcp/adapters |
Generate tools from an OpenAPI spec |
@frontmcp/skills |
Curated SKILL.md catalog for scaffolding and skills install |
@frontmcp/guard |
Rate limits, concurrency and policy guards |
@frontmcp/observability |
Structured logging, metrics and tracing |
@frontmcp/react |
React hooks and client for a FrontMCP server |
@frontmcp/ui / uipack |
Widgets, SSR renderers, MCP Bridge, themes |
@frontmcp/edge |
Run a server on Cloudflare Workers / V8 isolates |
@frontmcp/storage-sqlite |
SQLite session, task and elicitation stores |
@frontmcp/nx |
Nx generators and executors |
Internal, published so the above resolve: protocol, di, utils, lazy-zod.
| Package | What it does |
|---|---|
@frontmcp/plugin-cache |
Cache tool results with a TTL |
@frontmcp/plugin-remember |
Per-session memory (this.remember) |
@frontmcp/plugin-result-handles |
Fold large answers into a handle to query |
@frontmcp/plugin-approval |
Human approval gates before a tool runs |
@frontmcp/plugin-codecall |
Let the model compose tool calls as code |
@frontmcp/plugin-dashboard |
Built-in web dashboard |
@frontmcp/plugin-feature-flags |
Toggle tools and apps at runtime |
@frontmcp/plugin-skilled-openapi |
OpenAPI to skills and meta-tools for big APIs |
@frontmcp/plugin-webmcp |
Expose in-page tools to browser agents (WebMCP) |
PRs welcome: see CONTRIBUTING. Released under the Apache-2.0 license.
Preguntas sobre FrontMCP MCP
¿Cómo agrego FrontMCP MCP a Claude Code?
Ejecuta claude mcp add frontmcp -- npx -y @frontmcp/adapters en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego FrontMCP MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué es FrontMCP?
FrontMCP es un framework de TypeScript para construir MCP servers. Defines herramientas, recursos y prompts como clases tipadas con esquemas de Zod, y FrontMCP los sirve a través del Model Context Protocol.
¿Cómo creo un nuevo proyecto de FrontMCP?
Ejecuta npx frontmcp create my-app para generar la estructura de un nuevo proyecto, o npx frontmcp init para añadir FrontMCP a uno existente. Requiere Node 24 o superior.
¿Dónde puedo desplegar un servidor de FrontMCP?
El mismo servidor puede ejecutarse en Node.js, Vercel, AWS Lambda y Cloudflare Workers. Un paquete edge permite el soporte para Cloudflare Workers y V8 isolates.
¿FrontMCP admite autenticación?
Sí. El paquete @frontmcp/auth proporciona OAuth, JWKS, DCR/CIMD, sesiones y un almacén de credenciales.
¿Puedo probar un servidor de FrontMCP?
Sí, @frontmcp/testing ofrece un framework de pruebas end-to-end con fixtures y matchers, y el CLI incluye un comando para realizar tests.