Servidor MCP

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

¿Qué es el Servidor MCP de Oh My Posh?

El Servidor MCP (Model Context Protocol) de Oh My Posh es un servicio de validación que te permite verificar tus configuraciones de temas de oh-my-posh contra el esquema JSON oficial. Soporta formatos JSON, YAML y TOML, y proporciona reportes de errores detallados para ayudarte a crear configuraciones válidas.

Características

• Soporte Multi-formato: Valida configuraciones en JSON, YAML y TOML

• Reporte Detallado de Errores: Obtén errores de validación precisos con rutas JSON

• Detección Automática de Formato: Detecta automáticamente el formato de tu configuración

• Advertencias y Recomendaciones: Recibe sugerencias de buenas prácticas y avisos de desuso

• Basado en Estándares: Utiliza el esquema JSON oficial de oh-my-posh

• Acceso Remoto: No requiere instalación - acceso mediante HTTPS

Uso

Con Clientes MCP

Configura tu cliente compatible con MCP (como Claude Desktop, Cline u otros asistentes de IA) para usar el validador:

{
  "mcpServers": {
    "oh-my-posh-validator": {
      "url": "https://ohmyposh.dev/api/mcp",
      "transport": "http"
    }
  }
}

Luego pide a tu asistente de IA que valide tu configuración de oh-my-posh.

API HTTP Directa

También puedes usar el validador directamente mediante solicitudes HTTP.

Obtener Información del Servidor

curl https://ohmyposh.dev/api/mcp

Listar Herramientas Disponibles

curl -X POST https://ohmyposh.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

Validar una Configuración

curl -X POST https://ohmyposh.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "validate_config",
      "arguments": {
        "content": "{\"$schema\":\"https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json\",\"version\":4,\"blocks\":[]}",
        "format": "json"
      }
    },
    "id": 1
  }'

Parámetros de Herramientas

validate_config

Parámetros:

Parameter	Type	Required	Description
content	string	Yes	The configuration content as a string (JSON, YAML, or TOML)
format	string	No	The format: json, yaml, toml, or auto (default: auto)

Retorna:

{
  "valid": true,
  "errors": [],
  "warnings": [
    {
      "path": "$schema",
      "message": "Consider adding \"$schema\" property for better editor support.",
      "type": "recommendation"
    }
  ],
  "detectedFormat": "json",
  "parsedConfig": { ... }
}

Campos de Respuesta

Field	Type	Description
valid	boolean	Whether the configuration is valid
errors	array	List of validation errors (empty if valid)
warnings	array	List of warnings and recommendations
detectedFormat	string	The detected or specified format
parsedConfig	object	The parsed configuration object

Formato de Errores

Cada error en el array errors contiene:

Field	Type	Description
path	string	JSON path to the problematic property
message	string	Human-readable error message
keyword	string	The validation keyword that failed
params	object	Additional parameters about the error
data	any	The actual data that failed validation

Ejemplos

Configuración Válida

{
  "$schema": "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json",
  "version": 4,
  "blocks": [
    {
      "type": "prompt",
      "alignment": "left",
      "segments": [
        {
          "type": "path",
          "style": "powerline",
          "background": "blue",
          "foreground": "white"
        }
      ]
    }
  ]
}

Ejemplo de Configuración Inválida

{
  "blocks": [
    {
      "type": "invalid-type"
    }
  ]
}

Resultado de Validación:

{
  "valid": false,
  "errors": [
    {
      "path": "/blocks/0/type",
      "message": "Value must be one of: prompt, rprompt, line",
      "keyword": "enum"
    }
  ]
}

Ejemplos de Integración

Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/config.json en macOS):

{
  "mcpServers": {
    "oh-my-posh-validator": {
      "url": "https://ohmyposh.dev/api/mcp",
      "transport": "http"
    }
  }
}

Luego pregunta a Claude: "¿Puedes validar esta configuración de oh-my-posh?" y pega tu configuración.

Cline (Extensión de VS Code)

Configura Cline para usar el servidor MCP, y validará automáticamente las configuraciones cuando trabajes en temas de oh-my-posh.

Formatos Soportados

JSON

{
  "$schema": "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json",
  "version": 4,
  "blocks": []
}

YAML

$schema: https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json
version: 4
blocks: []

TOML

version = 4
blocks = []

Privacidad y Seguridad

• Tu contenido de configuración no se almacena ni se registra

• Toda validación se realiza en memoria y se descarta después del procesamiento

• El servidor solo lee el esquema oficial del repositorio

• No se requiere autenticación - completamente anónimo

Código Fuente

El servidor MCP es de código abierto y parte del repositorio de oh-my-posh:

• Función del Servidor MCP

• Módulo Validador

Solución de problemas

Formato No Detectado Correctamente

Si la detección automática falla, especifica explícitamente el formato:

{
  "arguments": {
    "content": "...",
    "format": "yaml"
  }
}

Errores de Análisis

Si obtienes errores de análisis, verifica que tu configuración tenga sintaxis JSON/YAML/TOML válida antes de validar el esquema.

Errores de Esquema

El validador utiliza el esquema más reciente de la rama principal. Si estás usando una versión anterior de oh-my-posh, es posible que algunas propiedades más nuevas no sean reconocidas.

Contribuciones

¿Encontraste un error o tienes una sugerencia? Por favor, abre un issue en GitHub.