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:
Un complemento de Obsidian que agrega capacidades MCP a su bóveda
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.
Related MCP server: MCP Claude Code
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 .
Instalar el complemento de Complementos de la comunidad de Obsidian
Habilite el complemento en la configuración de Obsidian
Abra la configuración del complemento
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:
Descargue el binario del servidor MCP apropiado
Utilice la clave API de su complemento API REST local
Configurar Claude Desktop para utilizar el servidor MCP
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:
Verifique la configuración del complemento para verificar:
Todos los complementos necesarios están instalados
El servidor está instalado correctamente
Claude Desktop está configurado
Revisar los registros:
Abrir la configuración del complemento
Haga clic en "Abrir registros" en Recursos
Busque mensajes de error o advertencias
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:
Instalar GitHub CLI:
# macOS (Homebrew) brew install gh # Windows (Scoop) scoop install gh # Linux sudo apt install gh # Debian/UbuntuVerificar 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
Instalar dependencias:
bun installConstruir todos los paquetes:
bun run buildPara desarrollo:
bun run dev
Requisitos
bun v1.1.42 o superior
TypeScript 5.0+
Contribuyendo
Bifurcar el repositorio
Crear una rama de características
Realiza tus cambios
Ejecutar pruebas:
bun testEnviar 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
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