convez.ai
MCP ServerIntegração & APIsIntermediário
vercel

MCP Handler Vercel

vercel/mcp-handler

Adapter MCP para Next.js e Nuxt com comunicação em tempo real com IA

Ver no GitHub
BomPluginScore · de 0 a 100

Adapter Vercel para o Model Context Protocol (MCP) que habilita comunicação em tempo real entre aplicações Next.js/Nuxt e modelos de IA. Permite registrar ferramentas customizadas e gerenciar transporte via HTTP Streamable ou SSE, com suporte opcional a Redis para resumibilidade.

Instalação

$npx convez-ai vercel/mcp-handler

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
705
Forks
98
Acompanhando
7
Saúde
50%
Último commit
há 1 dia
Versão
v2.4.0
Issues abertas
47
Contribuidores
24

Casos de uso

  • Integrar Claude e outros modelos de IA em aplicações Next.js/Nuxt
  • Expor ferramentas e recursos customizados via MCP para clientes de IA
  • Construir APIs que comunicam com Claude Desktop, Cursor e Windsurf

Veredito

Solução robusta e bem documentada da Vercel para integrar MCP em aplicações web modernas. Cobre os casos de uso principais (Next.js, Nuxt, autenticação, múltiplos transports) com uma API TypeScript clara e exemplos funcionais.

README

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

mcp-handler

A Vercel adapter for the Model Context Protocol (MCP), enabling real-time communication between your applications and AI models. Supports Next.js and Nuxt.

Installation

npm install mcp-handler @modelcontextprotocol/sdk@1.26.0 zod@^3

Note: Versions of @modelcontextprotocol/sdk prior to 1.26.0 have a security vulnerability. Use version 1.26.0 or later.

Quick Start (Next.js)

// app/api/[transport]/route.ts
import { createMcpHandler } from "mcp-handler";
import { z } from "zod";

const handler = createMcpHandler(
  (server) => {
    server.registerTool(
      "roll_dice",
      {
        title: "Roll Dice",
        description: "Roll a dice with a specified number of sides.",
        inputSchema: {
          sides: z.number().int().min(2),
        },
      },
      async ({ sides }) => {
        const value = 1 + Math.floor(Math.random() * sides);
        return {
          content: [{ type: "text", text: `🎲 You rolled a ${value}!` }],
        };
      }
    );
  },
  {},
  {
    basePath: "/api", // must match where [transport] is located
    maxDuration: 60,
    verboseLogs: true,
  }
);

export { handler as GET, handler as POST };

Connecting Clients

If your client supports Streamable HTTP, connect directly:

{
  "remote-example": {
    "url": "http://localhost:3000/api/mcp"
  }
}

For stdio-only clients, use mcp-remote:

{
  "remote-example": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "http://localhost:3000/api/mcp"]
  }
}

Documentation

Features

  • Framework Support: Next.js and Nuxt
  • Multiple Transports: Streamable HTTP and Server-Sent Events (SSE)
  • Redis Integration: Optional, for SSE transport resumability
  • TypeScript Support: Full type definitions included

Requirements

  • Next.js 13+ or Nuxt 3+
  • Node.js 18+
  • Redis (optional, for SSE)

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados