obsidian-plugin-skill MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Patrones de la API de plugins de Obsidian (Plugin/Notice/MarkdownView)
Manejo de manifest.json + versions.json + minAppVersion
Pestaña de configuración + extensiones del editor + comandos
Flujo de lanzamiento mediante tags de GitHub para la tienda Community
Estructura de TypeScript + esbuild

Demo en vivo

Cómo se ve en la práctica

obsidian-plugin-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-plugin-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-plugin-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/gapmiss/obsidian-plugin-skill",
          "~/.claude/skills/obsidian-plugin-skill"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add obsidian-plugin-skill -- git clone https://github.com/gapmiss/obsidian-plugin-skill ~/.claude/skills/obsidian-plugin-skill

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: obsidian-plugin-skill

Cómo construir y lanzar tu primer plugin de Obsidian

👤 Usuarios avanzados de Obsidian que quieren resolver una necesidad ⏱ ~120 min intermediate

Cuándo usarlo: Tienes una mejora de flujo de trabajo concreta y quieres un plugin en un día.

Requisitos previos

Node 18+ — nvm install 18
Un almacén local para pruebas — Crea un nuevo almacén de Obsidian solo para desarrollo
Skill clonada — git clone https://github.com/gapmiss/obsidian-plugin-skill ~/.claude/skills/obsidian-plugin-skill

Flujo

Genera el plugin

Genera un plugin de Obsidian llamado 'smart-outline' con un comando y una pestaña de configuración.✓ Copiado

→ Carpeta con manifest, main.ts, configuración de construcción
Añade la funcionalidad

Implementa: al ejecutar el comando, abre un modal que muestre el esquema de la nota activa.✓ Copiado

→ Modal funcionando leyendo desde la MarkdownView activa
Instala localmente y prueba

Instala en la carpeta de plugins del almacén de desarrollo y recarga Obsidian.✓ Copiado

→ El plugin aparece, el comando funciona
Prepara un lanzamiento

Crea versions.json y etiqueta un lanzamiento v0.1.0.✓ Copiado

→ Lanzamiento de GitHub con main.js + manifest.json adjuntos

Resultado: Un plugin funcional e instalable que puedes enviar a la tienda Community.

Errores comunes

Olvidar versions.json — la tienda Community rechaza — La Skill te lo recuerda; siempre mantente sincronizado con manifest.json
Referenciar internos de Obsidian que no son parte de la API — Apégate a la API pública; trata los internos como volátiles

Combinar con: filesystem · github

Añade una pestaña de configuración adecuada a un plugin existente

👤 Autores de plugins existentes mejorando la UX ⏱ ~30 min intermediate

Cuándo usarlo: Tu plugin ha crecido y necesita opciones configurables por el usuario.

Flujo

Diseña la configuración

Basándome en el README de mi plugin, ¿qué configuraciones deberían ser configurables por el usuario?✓ Copiado

→ Lista corta con justificación
Implementa PluginSettingTab

Añade una PluginSettingTab con esos controles.✓ Copiado

→ Interfaz de configuración en Obsidian

Resultado: Una pestaña de configuración que los usuarios realmente puedan usar.

Errores comunes

Demasiada configuración — Corta implacablemente — la configuración sin usar es desorden

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

obsidian-plugin-skill + filesystem

Lee un plugin existente y extiéndelo

Lee my-plugin/, añade un nuevo comando que exporte la nota activa como PDF.✓ Copiado

obsidian-plugin-skill + github

Automatiza el etiquetado y la creación de lanzamientos

Etiqueta v0.2.0 y publica el lanzamiento con los assets construidos.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
plugin-scaffolding	intención del plugin	Plugin nuevo
feature-authoring	especificación de funcionalidad + superficie de API	Cada funcionalidad
settings-tab	opciones	Mejoras de UX
release-flow	actualización de versión	Antes de publicar

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: ninguno
Tokens por llamada: 5–20k por plugin
Monetario: gratuito
Consejo: Trabaja funcionalidad por funcionalidad en lugar de descargar la especificación completa del plugin en Claude

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Token de GitHub para lanzamientos (si automatizas)

Salida de datos: ninguno en la capa de Skill

Los plugins se ejecutan con acceso total al almacén — revisa antes de instalar plugins de la comunidad

Resolución de problemas

Errores comunes y soluciones

Obsidian no carga el plugin

Confirma que manifest.json es JSON válido y está en la ruta correcta del almacén; recarga con Ctrl+R.

Verificar: cat .obsidian/plugins/my-plugin/manifest.json | jq .

La construcción no produce main.js

Ejecuta el comando esbuild; verifica el objetivo de tsconfig.

Verificar: ls main.js

Alternativas

obsidian-plugin-skill vs otros

Alternativa	Cuándo usarla	Contrapartida
logseq	Estás en Logseq en lugar de Obsidian	API de plugin diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills