Obsidian Index MCP Server

Servidor MCP de Obsidian Index

Un servidor MCP que proporciona una búsqueda semántica en una bóveda de Obsidian y expone notas recientes como recursos.

Componentes

Recursos

El servidor expone las notas recientemente modificadas en sus bóvedas como recursos para los clientes de MCP.

• Las notas se direccionan mediante un esquema de URL obsidian://<VAULT_NAME>/<NOTE_PATH>
• Las notas tienen el tipo de medio text/markdown

Herramientas

El servidor implementa una herramienta:

• search-notes : Realiza una búsqueda semántica sobre notas indexadas

Ejecutar el servidor

• --vault : Ruta a la bóveda de obsidiana (se puede especificar varias veces)
• --database : Ruta al archivo de base de datos local (se creará si no existe)
• --reindex : reindexa todas las notas en la bóveda (probablemente quieras esto cada vez ahora)
• --watch : vigila los cambios en el almacén y actualiza el índice en consecuencia

Inicio rápido

Instalar

Escritorio de Claude

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

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

2. Distribuciones de paquetes de compilación:

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.