Herramientas MCP para Obsidian

Características | Instalación | Configuración | Solución de problemas | Seguridad | Desarrollo | Soporte

MCP Tools para Obsidian permite que aplicaciones de IA como Claude Desktop accedan y trabajen de forma segura con su almacén de Obsidian mediante el Protocolo de Contexto de Modelo (MCP). MCP es un protocolo abierto que estandariza la interacción de las aplicaciones de IA con fuentes de datos y herramientas externas, manteniendo la seguridad y el control del usuario. [^2]

Este complemento consta de dos partes:

1. Un complemento de Obsidian que agrega capacidades MCP a su bóveda
2. Un servidor MCP local que gestiona la comunicación con aplicaciones de IA

Al instalar este complemento, le ayudará a configurar ambos componentes. El servidor MCP actúa como un puente seguro entre su almacén y las aplicaciones de IA como Claude Desktop. Esto significa que los asistentes de IA pueden leer sus notas, ejecutar plantillas y realizar búsquedas semánticas, pero solo cuando usted lo permita y únicamente a través de la API segura del servidor. El servidor nunca otorga a las aplicaciones de IA acceso directo a los archivos de su almacén. [^3]

Nota de privacidad : al usar Claude Desktop con este complemento, sus conversaciones con Claude no se utilizan para entrenar los modelos de Anthropic de forma predeterminada. [^1]

Características

Cuando se conecta a un cliente MCP como Claude Desktop, este complemento permite:

• Acceso a la bóveda : permite que los asistentes de IA lean y hagan referencia a sus notas mientras mantienen la seguridad de su bóveda [^4]
• Búsqueda semántica : los asistentes de IA pueden buscar en su bóveda según el significado y el contexto, no solo palabras clave [^5]
• Integración de plantillas : ejecute plantillas de Obsidian a través de interacciones de IA, con parámetros dinámicos y generación de contenido [^6]

Todas las funciones requieren un cliente compatible con MCP como Claude Desktop, ya que este complemento proporciona el componente de servidor que permite estas integraciones. El complemento no modifica directamente la funcionalidad de Obsidian; en cambio, crea un puente seguro que permite que las aplicaciones de IA interactúen con su almacén de forma eficaz.

Prerrequisitos

Requerido

• Obsidian v1.7.7 o superior
• Claude Desktop instalado y configurado
• Complemento de API REST local instalado y configurado con una clave API

Recomendado

• Complemento Templater para una funcionalidad mejorada de las plantillas
• Complemento Smart Connections para capacidades de búsqueda semántica

Instalación

[!Importante] Este complemento requiere un componente de servidor seguro que se ejecute localmente en su ordenador. El servidor se distribuye como un ejecutable firmado, con su código fuente completo disponible en packages/mcp-server/ . Para obtener más información sobre nuestras medidas de seguridad y el proceso de firma de código, consulte la sección de Seguridad .

1. Instalar el complemento de Complementos de la comunidad de Obsidian
2. Habilite el complemento en la configuración de Obsidian
3. Abra la configuración del complemento
4. Haga clic en "Instalar servidor" para descargar y configurar el servidor MCP

Al hacer clic en el botón de instalación se realizará lo siguiente:

• Descargue el binario del servidor MCP apropiado para su plataforma
• Configurar Claude Desktop para usar el servidor
• Configurar los permisos y rutas necesarios

Ubicaciones de instalación

• Binario del servidor : {vault}/.obsidian/plugins/obsidian-mcp-tools/bin/
• Archivos de registro :
  • macOS: ~/Biblioteca/Registros/obsidian-mcp-tools
  • Ventanas: %APPDATA%\obsidian-mcp-tools\logs
  • Linux: ~/.local/share/obsidian-mcp-tools/logs

Configuración

Después de hacer clic en el botón "Instalar servidor" en la configuración del complemento, este realizará automáticamente lo siguiente:

1. Descargue el binario del servidor MCP apropiado
2. Utilice la clave API de su complemento API REST local
3. Configurar Claude Desktop para utilizar el servidor MCP
4. Configurar rutas y permisos adecuados

Aunque el proceso de configuración es automático, se requiere su permiso explícito para instalar el binario del servidor y modificar la configuración de Claude Desktop. No se requiere ninguna configuración manual adicional más allá de este paso inicial.

Solución de problemas

Si encuentra problemas:

1. Verifique la configuración del complemento para verificar:
   • Todos los complementos necesarios están instalados
   • El servidor está instalado correctamente
   • Claude Desktop está configurado
2. Revisar los registros:
   • Abrir la configuración del complemento
   • Haga clic en "Abrir registros" en Recursos
   • Busque mensajes de error o advertencias
3. Problemas comunes:
   • El servidor no se inicia : asegúrese de que Claude Desktop se esté ejecutando
   • Errores de conexión : Verifique que el complemento API REST local esté configurado
   • Errores de permisos : Intente reinstalar el servidor

Seguridad

Distribución binaria

• Todas las versiones se crean utilizando GitHub Actions con compilaciones reproducibles.
• Los binarios están firmados y atestiguados utilizando la procedencia SLSA
• Los flujos de trabajo de lanzamiento son totalmente auditables en el repositorio

Seguridad en tiempo de ejecución

• El servidor MCP se ejecuta con los permisos mínimos requeridos
• Toda comunicación está encriptada
• Las claves API se almacenan de forma segura mediante el almacenamiento de credenciales específico de la plataforma

Verificación binaria

Los binarios del servidor MCP se publican con atestación de procedencia SLSA , que proporciona una prueba criptográfica de dónde y cómo se generaron. Esto ayuda a garantizar la integridad y la procedencia de los binarios que descarga.

Para verificar un binario usando la CLI de GitHub:

1. Instalar GitHub CLI:
   # macOS (Homebrew) brew install gh # Windows (Scoop) scoop install gh # Linux sudo apt install gh # Debian/Ubuntu
2. Verificar el binario:
   gh attestation verify --owner jacksteamdev <binary path or URL>

La verificación mostrará:

• El hash SHA256 del binario
• Confirmación de que fue creado por los flujos de trabajo de GitHub Actions de este repositorio
• El archivo de flujo de trabajo específico y la etiqueta de versión que lo creó
• Cumplimiento de los requisitos de construcción de nivel 3 de SLSA

Esta verificación garantiza que el binario no haya sido manipulado y que se haya creado directamente a partir del código fuente de este repositorio.

Informar sobre problemas de seguridad

Por favor, informe sobre vulnerabilidades de seguridad a través de nuestra política de seguridad . No informe sobre vulnerabilidades de seguridad en asuntos públicos.

Desarrollo

Este proyecto utiliza una estructura monorepositorio con arquitectura basada en características. Para obtener documentación detallada sobre la arquitectura del proyecto, consulte .clinerules .

Usando Cline

Parte del código de este proyecto se implementó con el agente de codificación de IA Cline . Cline utiliza cline_docs/ y el archivo .clinerules para comprender la arquitectura y los patrones del proyecto al implementar nuevas funciones.

Espacio de trabajo

Este proyecto utiliza una estructura de espacio de trabajo Bun :

Edificio

1. Instalar dependencias:
   bun install
2. Construir todos los paquetes:
   bun run build
3. Para desarrollo:
   bun run dev

Requisitos

• bun v1.1.42 o superior
• TypeScript 5.0+

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Realiza tus cambios
4. Ejecutar pruebas:
   bun test
5. Enviar una solicitud de extracción

Consulte CONTRIBUTING.md para obtener pautas detalladas.

Apoyo

• Abrir un problema para informes de errores y solicitudes de funciones
• Inicie una discusión para preguntas y ayuda general.

Registro de cambios

Consulte CHANGELOG.md para obtener una lista de cambios en cada versión.

Licencia

Licencia MIT

Notas al pie

[^1]: Para obtener información sobre la privacidad y seguridad de los datos de Claude, consulte la política de uso de datos de Claude AI [^2]: Para obtener más información sobre el Protocolo de contexto de modelo, consulte Introducción a MCP [^3]: Para obtener una lista de clientes MCP disponibles, consulte Clientes de ejemplo de MCP [^4]: Requiere el complemento Obsidian API REST local [^5]: Requiere el complemento Obsidian Smart Connections [^6]: Requiere el complemento Obsidian Templater