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

Related MCP server: Second Brain Control Plane MCP Server

Ejecutar el servidor

uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch

• --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:

uv sync

2. Distribuciones de paquetes de compilación:

uv build

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

3. Publicar en PyPI:

uv publish

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:

npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index

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