MCP HTTP Proxy

Um proxy HTTP para conectar VS Code ao servidor MCP (Model Context Protocol) via HTTP transport.

Instalação

npm install -g @natansiilva/mcp-http-proxy

Ou instale localmente:

npm install @natansiilva/mcp-http-proxy

Uso

Como comando global

mcp-http-proxy --server-url https://seu-servidor-mcp.com/stream

Como módulo Node.js

import { McpHttpProxy } from '@natansiilva/mcp-http-proxy';

const proxy = new McpHttpProxy({
  serverUrl: 'https://seu-servidor-mcp.com/stream',
  debug: true
});

await proxy.start();

Opções de linha de comando

• -s, --server-url <url>: URL do servidor MCP HTTP (obrigatório)
• -d, --debug: Ativa modo debug com logs detalhados
• -h, --help: Mostra ajuda

Configuração no VS Code

Adicione ao seu settings.json:

{
  "mcp.servers": {
    "meu-servidor": {
      "command": "mcp-http-proxy",
      "args": ["--server-url", "https://seu-servidor-mcp.com/stream"]
    }
  }
}

Como funciona

Este proxy atua como um bridge entre:

• Entrada (stdin): Mensagens JSON-RPC do VS Code
• Saída (stdout): Respostas JSON-RPC para o VS Code
• HTTP: Comunicação com o servidor MCP via HTTP

O proxy:

1. Recebe mensagens JSON-RPC do VS Code via stdin
2. Envia essas mensagens para o servidor MCP via HTTP POST
3. Processa as respostas (incluindo formato Server-Sent Events)
4. Retorna as respostas para o VS Code via stdout

API

McpHttpProxy

Classe principal do proxy.

Constructor

new McpHttpProxy(config: ProxyConfig)

ProxyConfig

interface ProxyConfig {
  serverUrl: string;  // URL do servidor MCP
  debug?: boolean;    // Ativa logs de debug (padrão: false)
}

Métodos

• start(): Inicia o proxy
• stop(): Para o proxy

McpHttpClient

Cliente HTTP para comunicação com o servidor MCP.

JsonRpcLineParser

Parser de stream para processar mensagens JSON-RPC linha por linha.

Desenvolvimento

# Instalar dependências
npm install

# Compilar TypeScript
npm run build

# Executar em modo desenvolvimento
npm run dev

# Executar versão compilada
npm start

Licença

MIT

Contribuição

Contribuições são bem-vindas! Por favor, abra uma issue ou pull request.