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

Hono MCP Server SSE Transport

NikaBuligini/hono-mcp-server-sse-transport

Transport MCP com SSE para Hono, alternativa ao Express até suporte oficial

Ver no GitHub
InicialPluginScore · de 0 a 100

Transport via Server-Sent Events (SSE) para conectar aplicações Hono ao Model Context Protocol. Resolve incompatibilidades entre o SDK oficial do MCP (desenhado para Express) e o framework Hono, permitindo streaming bidirecional de mensagens através de SSE.

Instalação

$npx convez-ai NikaBuligini/hono-mcp-server-sse-transport

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
28
Forks
3
Acompanhando
1
Saúde
42%
Último commit
há 1 ano
Versão
v0.0.7
Issues abertas
0
Contribuidores
4

Casos de uso

  • Conectar servidores Hono ao Protocol Model Context Protocol
  • Implementar streaming de eventos server-sent em aplicações MCP
  • Gerenciar múltiplas conexões simultâneas de clientes MCP

Veredito

Solução específica e bem-focada para um gap real: suporte a MCP no Hono antes do SDK oficial. Implementação sólida usando SSE, mas com escopo bem delimitado — útil principalmente para quem já trabalha com Hono e MCP.

README

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

MCP Server transport for Hono applications

Overview

This project provides a transport for Hono application that needs to connect to MCP Server. An official TypeScript SDK is designed to be used with express. If you try and follow their instructions but change express with hono, you will find that it's not going to work. Even if you set HttpBinding as an env (see an example from @hono/node-server), it still doesn't work as some headers are being added to a response after it's sent.

This implementation is inspired by the following pull request

You can use this transport until there is a proper support for Hono in the official SDK.

Getting started

Installation

pnpm add -D hono-mcp-server-sse-transport

Usage

import { Hono } from 'hono';
import { serve } from '@hono/node-server';
import { streamSSE } from 'hono/streaming';
import { SSETransport } from 'hono-mcp-server-sse-transport';
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

const mcpServer = new McpServer(
  {
    name: 'your-mcp-server-name',
    version: '1.0.0',
  },
  {
    capabilities: {
      tools: {},
    },
  },
);

// here you add your tools
// ...

const app = new Hono();

// to support multiple simultaneous connections we have a lookup object from
// sessionId to transport
const transports: { [sessionId: string]: SSETransport } = {};

app.get('/sse', (c) => {
  return streamSSE(c, async (stream) => {
    const transport = new SSETransport('/messages', stream);

    transports[transport.sessionId] = transport;

    stream.onAbort(() => {
      delete transports[transport.sessionId];
    });

    await mcpServer.connect(transport);

    while (true) {
      // This will keep the connection alive
      // You can also await for a promise that never resolves
      await stream.sleep(60_000);
    }
  });
});

app.post('/messages', async (c) => {
  const sessionId = c.req.query('sessionId');
  const transport = transports[sessionId];

  if (transport == null) {
    return c.text('No transport found for sessionId', 400);
  }

  return await transport.handlePostMessage(c);
});

serve(
  {
    fetch: app.fetch,
    port: 3000,
  },
);
Ver o original no GitHub

Bom para

Relacionados