Servidor MCP Obsidian Omnisearch

Un servidor basado en FastMCP que proporciona la funcionalidad de búsqueda de bóveda de Obsidian a través de una interfaz API REST.

Descripción general

Este proyecto implementa un servicio de búsqueda que permite buscar en las notas de la bóveda de Obsidian mediante programación. Utiliza FastMCP para exponer la funcionalidad de búsqueda como una herramienta integrable con otros servicios.

Related MCP server: Obsidian MCP Server

Características

• Buscar en las notas de la bóveda de obsidiana

• Integración de API REST

• Devuelve rutas absolutas a las notas coincidentes

• Fácil integración con las herramientas FastMCP

Prerrequisitos

• Python 3.x

• Obsidian con el complemento Omnisearch instalado y en ejecución

• Biblioteca FastMCP

• Bóveda de obsidiana activa

Instalación

Instalación mediante herrería

Para instalar MCP Server Obsidian Omnisearch para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude

Instalación manual

1. Clonar el repositorio:

git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch

2. Instalar dependencias:

uv install

Configuración

La ruta de la bóveda de Obsidian ahora se proporciona como un argumento de línea de comando al ejecutar el servidor:

python server.py /path/to/your/obsidian/vault

Uso

API de búsqueda omnidireccional de Obsidian

Necesita el complemento de la comunidad Obsidian Omnisearch en ejecución: https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine

Escritorio de Claude

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

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-omnisearch": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-server-obsidian-omnisearch",
        "run",
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

{
  "mcpServers": {
    "obsidian-omnisearch": {
      "command": "uvx",
      "args": [
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

Referencia de API

Notas de búsqueda

• Función: obsidian_notes_search(query: str)

• Descripción: Busca notas de Obsidian y devuelve rutas absolutas a las notas coincidentes

• Parámetros:

  • query : cadena de consulta de búsqueda

• Devuelve: Lista de rutas absolutas a notas coincidentes

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/mcp-server-obsidian-omnisearch run mcp-server-obsidian-omnisearch

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

También puedes ver los registros del servidor con este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-server-obsidian-omnisearch.log

Dependencias

• FastMCP

• solicitudes

• urllib

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.