Vynix MCP

Servidor de Model Context Protocol para Vynix. Proporciona a los agentes de codificación acceso directo a comentarios visuales, informes de errores, capturas de pantalla, diagnósticos, comentarios y flujos de trabajo de incidencias, para que los agentes puedan razonar a partir del contexto real en lugar de adivinar.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor Vynix MCP

npm version npm downloads license ci vynix-mcp MCP server smithery badge

Servidor de Model Context Protocol para Vynix. Proporciona a los agentes de codificación acceso directo a comentarios visuales, informes de errores, capturas de pantalla, diagnósticos, comentarios y flujos de trabajo de incidencias, para que los agentes puedan razonar a partir del contexto real en lugar de adivinar.

Por qué Vynix

  • Comentarios con evidencia: metadatos de página, elemento objetivo, captura de pantalla, contexto de consola/red.
  • Ejecución de extremo a extremo: inspeccionar comentarios, diagnosticar, generar prompts de codificación, crear incidencias de GitHub, actualizar estado, comentar.
  • Sugerencias seguras para agentes: anotaciones de solo lectura/idempotentes/mundo abierto para un mejor comportamiento de aprobación en clientes MCP.
  • Metadatos listos para registros en directorios MCP modernos.

Capturas de pantalla

  • Marcador de posición de captura de producto: docs/assets/screenshot-dashboard.png
  • Marcador de posición de GIF de flujo de trabajo: docs/assets/workflow-fix-annotation.gif

Arquitectura

flowchart LR
  A[MCP Client\nClaude/Cursor/Copilot/VS Code] -->|stdio or streamable-http| B[Vynix MCP Server]
  B --> C[Vynix API]
  B --> D[GitHub API via Vynix backend]
  C --> E[Projects]
  C --> F[Annotations]
  C --> G[Screenshots and diagnostics]

Características

  • 17 herramientas de producción para flujos de trabajo de lectura y escritura.
  • Catálogo de recursos para metadatos del servidor, referencias de herramientas/prompts/habilidades y resúmenes contextuales.
  • Prompts de flujo de trabajo para QA, preparación de lanzamientos, informes de gestión y planificación de ingeniería.
  • Soporte de transporte dual: stdio y HTTP Streamable.
  • Autenticación mediante token de API o flujo de actualización con correo electrónico/contraseña.

Instalación

Se requiere Node.js 18+.

NPX (recomendado)

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_URL": "https://www.vynix.in",
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Instalación global de npm

npm install -g @usevynix/mcp-server
vynix-mcp

Docker

docker run --rm -i \
  -e VYNIX_API_URL=https://www.vynix.in \
  -e VYNIX_API_TOKEN=PASTE_YOUR_TOKEN_HERE \
  ghcr.io/usevynix/vynix-mcp:latest

Desarrollo local

git clone https://github.com/UseVynix/vynix-mcp.git
cd vynix-mcp
npm install
npm run build
npm run check
node dist/index.js

Configuración del cliente

Claude Desktop

Usa claude_desktop_config.json:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Los diagnósticos se escriben en stderr; stdout está reservado para el flujo del protocolo.

Cursor

Usa ~/.cursor/mcp.json.

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code

Usa .vscode/mcp.json con el nivel superior servers:

{
  "servers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Windsurf

Usa tu archivo de configuración MCP de Windsurf con este bloque de servidor:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Conectores de ChatGPT

Para el modo alojado, usa el endpoint HTTP Streamable:

  • URL base: https://mcp.vynix.in/mcp
  • Descubrimiento OAuth: /.well-known/oauth-authorization-server

mcp.json genérico

Consulta examples/configs/mcp.json.

Autenticación

Variables de entorno:

  • VYNIX_API_URL (opcional, por defecto: https://www.vynix.in)
  • VYNIX_API_TOKEN (recomendado)
  • VYNIX_API_EMAIL y VYNIX_API_PASSWORD (modo de inicio de sesión de respaldo)
  • VYNIX_MCP_MODE (stdio o http)
  • VYNIX_MCP_HOST, VYNIX_MCP_PORT, VYNIX_MCP_PATH (modo HTTP)

Genera un token desde: https://www.vynix.in/mcp

Herramientas, Prompts y Recursos

Ejemplos

Solución de problemas

  • Error Not configured: establece VYNIX_API_TOKEN o ambos VYNIX_API_EMAIL y VYNIX_API_PASSWORD.
  • Errores 401: regenera el token y verifica la URL de la API.
  • No se listan herramientas: confirma la clave de configuración MCP (mcpServers vs servers) para tu cliente.
  • Modo alojado no accesible: verifica VYNIX_MCP_MODE=http y revisa /health.

Preguntas frecuentes

¿Esto envía datos a proveedores de IA de terceros?

Solo diagnose_annotation puede invocar proveedores de IA externos a través de la configuración de tu espacio de trabajo de Vynix.

¿Esto es de solo lectura?

No. Incluye herramientas de lectura y escritura. Las anotaciones MCP identifican llamadas mutantes/de mundo abierto para que los clientes puedan solicitar confirmación.

¿Puedo autoalojarlo?

Sí. Ejecuta en modo stdio localmente o en modo HTTP detrás de tu propia infraestructura.

Contribuciones

Consulta CONTRIBUTING.md. Para validación local ejecuta:

npm run check

Seguridad

  • Nunca confirmes tokens de API.
  • Prefiere tokens de corta duración cuando sea posible.
  • Consulta SECURITY.md (crea uno si tu organización requiere una política de divulgación).

Licencia

MIT

Registro de cambios

CHANGELOG.md