convez.ai
MCP ServerProdutividadeIntermediário
Fralopala2

OpenCode Panel

Fralopala2/opencode-mcp

Chat integrado no VS Code para seus agents e skills OpenCode locais

Ver no GitHub
InicialPluginScore · de 0 a 100

Extensão para VS Code/Antigravity que integra um painel de chat lateral conectado ao seu servidor local OpenCode. Permite acessar agents, skills, MCP providers e ferramentas configuradas diretamente do editor, com suporte a histórico persistente, gestão de erros, failover de API keys e rastreamento de custos em tempo real.

Instalação

$npx convez-ai Fralopala2/opencode-mcp

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
5
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Executar agents e skills de IA diretamente no editor de código
  • Gerenciar múltiplas sessões de chat com histórico persistente por workspace
  • Monitorar custos acumulativos de APIs em tempo real
  • Implementar failover automático de chaves API em caso de erros ou limites de quota
  • Adicionar contexto de arquivos e seleções às conversas com IA

Veredito

Ferramenta bem arquitetada para quem trabalha com OpenCode e VS Code. A integração é sólida com recursos avançados (failover, gestão de custos, histórico persistente), mas a utilidade é limitada ao ecosistema OpenCode específico. Recomendado para desenvolvedores que já usam OpenCode e precisam de produtividade aprimorada no editor.

README

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

OpenCode Panel (VS Code / Antigravity)

Esta extensión para VS Code / Antigravity es un panel lateral de chat conectado directamente a tu instancia local de OpenCode. Permite interactuar con tus agents, skills, MCP y providers configurados en ~/.config/opencode/opencode.jsonc e incorpora características avanzadas como historial de chat persistente, gestión de errores, adaptador MCP, agente de failover y panel de costos acumulativos en tiempo real.

Interfaz PrincipalPanel de CostosAjustes y Modelos

Características

  • Conexión directa con tu servidor local de OpenCode.
  • Interfaz de chat integrada en el panel lateral de VS Code.
  • Gestión de contexto: añade archivos, selecciones o todos los archivos abiertos al contexto de la conversación.
  • Autenticación básica para servidores protegidos.
  • Auto-inicio del servidor si no está en ejecución.
  • Soporte para múltiples sesiones de chat.
  • Historial persistente: las sesiones se guardan y asocian automáticamente al workspace (proyecto) actual, manteniéndose entre reinicios.
  • Gestión de errores detallada: los mensajes de error de los proveedores (ej. cuota excedida, saldo insuficiente) se parsean y muestran nativamente en el chat.
  • Adaptador MCP (opencode-adapter.mjs) para acceder a OpenCode desde otros clientes MCP mediante la herramienta ask_opencode.
  • Agente de Failover y Balanceo API (FailoverAgent) para rotar llaves de API automáticamente al detectar fallos o límites de cuota (429), con persistencia del modelo de respaldo sin mutar la selección original del usuario.
  • Panel de costos acumulativos: seguimiento en tiempo real del costo por sesión agrupado por fecha y modelo, con soporte multi‑moneda (USD/EUR) y persistencia en el almacenamiento global de VS Code.
  • Seguridad reforzada: CSP restrictiva en el webview, sanitización de salida HTML, comandos sin shell (execFile), y rutas de auth configurables vía OPENCODE_AUTH_PATH.
  • Robustez y estabilidad: Timeout de 3 minutos con cancelación automática, reconexión automática (hasta 3 intentos con backoff exponencial), failover de API keys con rotación entre proveedores, parsing SSE tolerante a CRLF/LF, y detección de caídas de conexión SSE para no dejar el chat colgado.
  • Mejoras de Interfaz: Botones de contexto dedicados, dropdowns independientes para Modelo, Agente y Modo (filtrando agentes internos), selecciones robustas por ID, panel de costos con cierre explícito, acceso directo a configuración de la extensión y feedback visual inmediato.

Requisitos

  • OpenCode CLI instalado y disponible en el PATH.
  • Node.js (para la ejecución del adaptador MCP y scripts de Failover).
  • VS Code 1.85 o superior.
  • Carpeta de workspace abierta (recomendado).

Instalación y uso

Instalación

Puedes instalar la extensión directamente desde el Marketplace de VS Code:

  1. Abre la vista de Extensiones en VS Code (Ctrl+Shift+X).
  2. Busca opencode-mcp-vscode o visita el enlace OpenCode Chat Panel.
  3. Haz clic en Instalar.

(Alternativamente, puedes instalarla desde tu navegador a través del Marketplace de VS Code).

Uso

  1. Asegúrate de tener instalado y configurado OpenCode CLI en tu sistema.
  2. Abre el panel de OpenCode desde la barra de actividad (icono de OpenCode) o usando el atajo Ctrl+Alt+O.
  3. Escribe tu consulta en el panel de chat y envíala con Enviar o Ctrl+Enter.

Si el servidor de OpenCode no está en ejecución y la opción opencode.autoStartServer está activada (valor por defecto), la extensión iniciará automáticamente el servidor con opencode serve en el puerto configurado.

Herramientas y Agentes

Al estar conectado directamente a OpenCode, el panel hereda todas sus herramientas (Tools/MCP) permitiendo al LLM interactuar con tu entorno:

Herramientas Nativas (Tools)

  • Sistema y archivos: Ejecución de comandos (bash), búsqueda (glob, grep), lectura (read), edición (edit) y escritura (write).
  • Memoria persistente: Gestión de contexto a largo plazo (mem_save, mem_search, mem_context, mem_update).
  • Tareas complejas: Delegación de subtareas (task) y listas de TODOs (todowrite).
  • Web y UI: Acceso a internet (webfetch) y preguntas interactivas (question).
  • Skills: Habilidades especializadas personalizadas (skill).

Adaptador MCP (OpenCode MCP Server)

El archivo opencode-adapter.mjs funciona como un servidor Model Context Protocol (MCP) que permite a clientes MCP comunicarse con tu servidor OpenCode local.

  • Expone la tool ask_opencode para el envío de consultas de manera estructurada.
  • Se comunica por stdio, arranca automáticamente opencode serve si no está encendido, y devuelve respuestas de los agentes y herramientas de OpenCode.

Configuración en clientes MCP (ej. Claude Desktop)

Para integrar este adaptador en Claude Desktop, añade lo siguiente a tu archivo de configuración (claude_desktop_config.json):

{
  "mcpServers": {
    "opencode-mcp": {
      "command": "node",
      "args": ["/ruta/absoluta/a/opencode-mcp/opencode-adapter.mjs"]
    }
  }
}

Agente Failover y Balanceo de API

La extensión incluye una solución nativa para garantizar resiliencia en llamadas al LLM integrada de forma segura.

  • Configuración Segura: Ejecuta el comando OpenCode: Configurar API Keys de Failover (opencode.setApiKeys) y pega tu JSON con las baterías de APIs por proveedor (ej. {"openai": ["sk-...", "sk-..."]}). Esto se guardará cifrado en el llavero de tu sistema operativo mediante el SecretStorage de VS Code.
  • Rotación Automática: Si la API devuelve error HTTP 429 (Rate Limit) o > 500, la extensión cambia dinámicamente a la siguiente llave y reintenta la petición de forma transparente al usuario.

Gestión de contexto

Puedes añadir contenido al contexto de la conversación para que OpenCode lo tenga en cuenta al responder utilizando los botones de la interfaz del chat o los siguientes atajos:

AcciónAtajoComando
Añadir archivo actualCtrl+Alt+Shift+FOpenCode: Añadir archivo actual al contexto
Añadir selecciónCtrl+Alt+Shift+SOpenCode: Añadir selección al contexto
Añadir todos los abiertos—OpenCode: Añadir archivos abiertos al contexto
Añadir estado de Git—OpenCode: Añadir información de Git al contexto (opencode.addGitContext)
Adjuntar carpeta—(Desde el botón en la interfaz de chat)

También puedes acceder a estas opciones desde el menú contextual del editor o del explorador de archivos. El estado de Git incluye tu rama actual, archivos modificados y los últimos 5 commits.

Panel de Costos Acumulativos

El panel de costos muestra el gasto acumulado de tus interacciones con los LLMs, agrupado por fecha y modelo.

Características

  • Cálculo automático: cada respuesta del asistente registra los tokens de entrada y salida y calcula el costo según el modelo utilizado.
  • Agrupación por fecha y modelo: los costos se organizan por día y por modelo de LLM.
  • Multi-moneda: muestra el costo en USD y EUR (tasa fija EUR = USD × 0.92).
  • Persistencia: los datos se guardan en el almacenamiento global de VS Code y se cargan automáticamente al abrir el chat.
  • Panel ocultable: botón de mostrar/ocultar en la barra superior del chat.

Precios por modelo

ModeloPrecio Input (por 1M tokens)Precio Output (por 1M tokens)
mistral-medium-latest$2.00$6.00
Default (otros)$2.00$6.00

Funcionamiento

  1. Al abrir el chat, el panel carga los costos históricos desde el almacenamiento global de VS Code.
  2. Cada respuesta del asistente acumula el costo automáticamente (tanto en el frontend como en el backend).
  3. El backend persiste los costos en el almacenamiento global de VS Code tras cada interacción.
  4. Puedes ocultar/mostrar el panel con el botón $ en la barra superior.

Configuración

La extensión ofrece las siguientes opciones de configuración:

ConfiguraciónValor por defectoDescripción
opencode.serverUrlhttp://127.0.0.1:4096URL del servidor OpenCode.
opencode.serverPort4096Puerto utilizado al iniciar el servidor automáticamente.
opencode.autoStartServertrueIniciar el servidor automáticamente si no está en ejecución.
opencode.serverUsernameopencodeUsuario para autenticación básica HTTP (si se usa contraseña).
opencode.serverPassword""Contraseña para autenticación básica HTTP (definida en OPENCODE_SERVER_PASSWORD).
opencode.defaultAgent""Nombre del agente por defecto (según tu configuración de OpenCode).
opencode.autoApprovePermissionsfalseAprobar automáticamente permisos para comandos bash o edición de archivos.
opencode.bin""Ruta al ejecutable de OpenCode (vacío = auto-detección en Windows/npm).
opencode.quickActions[...]Acciones rápidas personalizadas en la pantalla de bienvenida.

Conexión con OpenCode LOCAL

La extensión se comunica con tu instancia local de OpenCode (que se inicia con opencode serve) a través de su HTTP API local (por defecto en http://127.0.0.1:4096):

  • GET /global/health: Comprueba el estado del servidor.
  • POST /session: Inicia una sesión de chat por workspace.
  • POST /session/:id/prompt_async: Envía un mensaje al servidor (utiliza tus agents/MCP configurados).
  • GET /event: Recibe el streaming de respuestas.
  • GET /agent: Lista los agents disponibles en tu configuración.

Los MCP (Micro-Core Protocols) se gestionan directamente desde tu configuración de OpenCode, por lo que no es necesario configurarlos en la extensión.

Comandos disponibles

ComandoDescripción
opencode.askAbre el panel de chat de OpenCode.
opencode.reconnectReconecta al servidor de OpenCode.
opencode.newSessionInicia una nueva sesión de chat (equivalente al botón Limpiar chat de la interfaz).
opencode.addFileToContextAñade el archivo actual al contexto.
opencode.addSelectionToContextAñade la selección actual al contexto.
opencode.addOpenFilesToContextAñade todos los archivos abiertos al contexto.

Desarrollo

Para contribuir al desarrollo de la extensión:

  1. Instala las dependencias:

    npm install
    
  2. Compila el proyecto:

    npm run compile
    
  3. Durante el desarrollo, usa el modo watch para compilar automáticamente los cambios:

    npm run watch
    
  4. Ejecuta las pruebas (si están disponibles):

    npm test
    
  5. Para empaquetar la extensión:

    npm run package
    

Estructura del proyecto

  • src/: Contiene el código fuente de la extensión.
    • extension.ts: Punto de entrada principal.

    • opencodeService.ts: Lógica para la comunicación con el servidor de OpenCode.

    • chatViewProvider.ts: Implementación del panel de chat.

    • serverProcess.ts: Gestión del proceso del servidor de OpenCode.

    • httpClient.ts: Cliente HTTP para las solicitudes al servidor.

    • contextAttachments.ts: Lógica para manejar el contexto de archivos y selecciones.

    • settings.ts: Gestión de la configuración de la extensión.

    • types.ts: Definiciones de tipos TypeScript.

    • agent/failoverAgent.js: Lógica de balanceo de API y rotación de keys.

    • opencode-adapter.mjs: Servidor MCP que expone OpenCode.

    • config/apis.json: Configuración de llaves maestras para Failover.

    • resources/webview/: Contiene los assets del frontend del chat.

      • index.html: Estructura HTML del panel de chat (incluye el panel de costos).
      • main.js: Lógica del frontend (manejo de mensajes, renderizado, cálculo de costos).
      • styles.css: Estilos del panel de chat.
    • package.json: Configuración del proyecto y dependencias.

Solución de problemas

  • OpenCode no responde: Verifica que opencode.autoStartServer esté activo o ejecuta opencode serve.
  • Error de conexión (Timeout): Asegúrate de que el puerto de opencode.serverPort esté libre.
  • Error de autenticación: Ingresa la contraseña en opencode.serverPassword si tu servidor la requiere.
  • Bloqueo por permisos: Activa opencode.autoApprovePermissions o aprueba manualmente si el chat se cuelga.

Licencia

MIT

Ver o original no GitHub

Bom para

Relacionados