Skip to main content
Glama

MCP Obsidian

Obsidiana MCP

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración con Obsidian . Esto permite que los asistentes de IA lean, creen y manipulen notas en su bóveda de Obsidian.

Características

  • Leer el archivo activo en Obsidian
  • Eliminar el archivo activo
  • Insertar contenido en posiciones específicas (encabezados, referencias de bloque, portadas)
  • Añadir contenido a los archivos
  • Abrir archivos específicos
  • Lista de archivos en tu bóveda
  • Busca entre tus notas

Prerrequisitos

  • Tiempo de ejecución de Bun
  • Aplicación de escritorio Obsidian
  • Un asistente de IA compatible con MCP

Añadir al cursor

Coloque su secreto en el archivo .env

Seleccione el comando MCP y luego ingrese este comando

bun __REPO_PATH__/src/index.ts

Instalación

  1. Clonar este repositorio:
    git clone https://github.com/gregkonush/mcp-obsidian.git cd mcp-obsidian
  2. Instalar dependencias:
    bun install
  3. Copie el archivo de entorno de ejemplo y configúrelo:
    cp .env.example .env

Configuración

Edite el archivo .env con sus configuraciones específicas:

OBSIDIAN_BASE_URL=http://localhost:27123 OBSIDIAN_TOKEN=your_token_here DEBUG=false

Uso

Inicie el servidor MCP:

bun run src/index.ts

El servidor se iniciará y se comunicará con los asistentes de IA compatibles con MCP a través de E/S estándar.

Herramientas disponibles

Esta implementación proporciona las siguientes herramientas a los asistentes de IA:

  • get_active_file - Devuelve el contenido del archivo actualmente activo
  • delete_active_file - Elimina el archivo actualmente activo
  • insert_active_file - Modifica el contenido relativo a un encabezado, una referencia de bloque o un campo frontmatter
  • append_active_file - Agrega contenido al final del archivo activo
  • open_file - Abre un archivo específico en Obsidian
  • search_simple - Busca documentos que coincidan con una consulta de texto
  • list_files - Enumera los archivos en el directorio raíz de su bóveda
  • list_directory_files : enumera los archivos en un directorio específico de su bóveda

Desarrollo

Estructura del proyecto

mcp-obsidian/ ├── src/ │ ├── index.ts # Main server implementation │ └── tools/ # Individual tool implementations │ ├── get-active-file.ts │ ├── delete-active-file.ts │ └── ... ├── .env # Environment configuration ├── package.json # Project dependencies └── tsconfig.json # TypeScript configuration

Agregar nuevas herramientas

Para agregar una nueva herramienta:

  1. Crea un nuevo archivo en el directorio src/tools/
  2. Implementar la herramienta utilizando el SDK de MCP
  3. Importar y registrar la herramienta en src/index.ts

Licencia

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

Contribuyendo

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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Una implementación de servidor que permite a los asistentes de IA leer, crear y manipular notas en bóvedas de Obsidian a través del Protocolo de Contexto de Modelo.

  1. Características
    1. Prerrequisitos
      1. Añadir al cursor
        1. Instalación
          1. Configuración
            1. Uso
              1. Herramientas disponibles
                1. Desarrollo
                  1. Estructura del proyecto
                  2. Agregar nuevas herramientas
                2. Licencia
                  1. Contribuyendo

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
                      Last updated -
                      598
                      149
                      TypeScript
                      MIT License
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.
                      Last updated -
                      37
                      TypeScript
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.
                      Last updated -
                      598
                      7
                      JavaScript
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.
                      Last updated -
                      12
                      122
                      21
                      TypeScript
                      MIT License

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/gregkonush/mcp-obsidian'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server