Repolode
Enviar
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

Servidor MCP que permite a assistentes de IA ler, pesquisar, acrescentar conteúdo e excluir notas em um vault do Obsidian usando o plugin Local REST API.

Ver no GitHub
Estrelas
4,524
Forks
507
Issues abertas
107
Último commit
há 2 meses

O que é?

mcp-obsidian é um servidor do Model Context Protocol (MCP) que conecta clientes de IA, como o Claude Desktop, a um vault do Obsidian. Ele funciona por meio do plugin comunitário Local REST API do Obsidian; portanto, o Obsidian precisa estar em execução, com o plugin ativado e uma chave de API configurada.

Depois de conectado, o assistente pode listar arquivos e pastas do vault, ler o conteúdo de uma nota, pesquisar texto em todos os arquivos, inserir conteúdo em relação a um título, uma referência a bloco ou um campo de frontmatter, acrescentar conteúdo a um arquivo novo ou existente e excluir arquivos ou diretórios. A configuração usa uma chave de API e, opcionalmente, host e porta, que por padrão são 127.0.0.1 e 27124.

O projeto pode ser executado com uvx, em um ambiente uv local ou em um contêiner Docker que acessa o host por meio de host.docker.internal. Ele requer Python 3.11 ou posterior e uma versão do SDK mcp para Python anterior à 2.0.

Recursos principais

  • 01Lista arquivos e diretórios na raiz do vault ou em uma pasta específica.
  • 02Lê todo o conteúdo de uma única nota.
  • 03Pesquisa texto em todos os arquivos do vault.
  • 04Insere conteúdo em notas em relação a títulos, referências a blocos ou campos de frontmatter.
  • 05Acrescenta conteúdo a arquivos novos ou existentes e exclui arquivos ou diretórios.

Casos de uso

  • Pedir a um assistente de IA que resuma ou explique notas armazenadas no Obsidian.
  • Pesquisar no vault todas as menções a um tema e analisar o contexto ao redor.
  • Gerar automaticamente uma nova nota de resumo de reunião a partir de notas existentes.
  • Permitir que um assistente de IA mantenha e atualize notas em uma base de conhecimento pessoal.

Início rápido

  1. 1

    Instale e ative o plugin comunitário Obsidian Local REST API e copie a chave de API

  2. 2

    Adicione o servidor à configuração do seu cliente MCP com OBSIDIAN_API_KEY, OBSIDIAN_HOST e OBSIDIAN_PORT definidos

  3. 3

    Execute o servidor publicado com uvx

    uvx mcp-obsidian

Antes de usar

  • É necessário instalar o plugin comunitário Obsidian Local REST API e mantê-lo em execução no Obsidian.
  • É necessário usar Python 3.11 ou posterior, e a dependência mcp deve permanecer abaixo da versão 2.0.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

#mcp#obsidian#notes#knowledge-management#llm#python#ai-agent

Perguntas frequentes

O que é mcp-obsidian?
Servidor MCP que permite a assistentes de IA ler, pesquisar, acrescentar conteúdo e excluir notas em um vault do Obsidian usando o plugin Local REST API. mcp-obsidian é um servidor do Model Context Protocol (MCP) que conecta clientes de IA, como o Claude Desktop, a um vault do Obsidian. Ele funciona por meio do plugin comunitário Local REST API do Obsidian; portanto, o Obsidian precisa estar em execução, com o plugin ativado e uma chave de API configurada.
mcp-obsidian é gratuito? Qual é a licença?
mcp-obsidian é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-obsidian ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mcp-obsidian foi em 31 de ago. de 2026.
Para que posso usar mcp-obsidian?
Pedir a um assistente de IA que resuma ou explique notas armazenadas no Obsidian. Pesquisar no vault todas as menções a um tema e analisar o contexto ao redor. Gerar automaticamente uma nova nota de resumo de reunião a partir de notas existentes. Permitir que um assistente de IA mantenha e atualize notas em uma base de conhecimento pessoal.
Como instalar mcp-obsidian?
Instale e ative o plugin comunitário Obsidian Local REST API e copie a chave de API Adicione o servidor à configuração do seu cliente MCP com OBSIDIAN_API_KEY, OBSIDIAN_HOST e OBSIDIAN_PORT definidos Execute o servidor publicado com uvx: uvx mcp-obsidian
Onde consigo mcp-obsidian?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MarkusPfundstein/mcp-obsidian

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados