Obsidian MCP Server

Um servidor MCP que permite que assistentes de IA leiam e escrevam em seu vault local do Obsidian.

GitHub
31
Experimente este MCPPatrocinado

Documentação

Obsidian MCP Server

Um servidor leve de Model Context Protocol (MCP) que permite que assistentes de IA como Cursor e Claude leiam e escrevam no seu vault do Obsidian.

Exemplos de Interações

  • "Crie uma nova nota para o standup de amanhã descrevendo as mudanças de código que fiz hoje" (também deve usar Git)
  • "Verifique minhas notas sobre ideias de projetos"
  • "Verifique quais tarefas tenho relacionadas a refatoração"

Ferramentas

Leitura

  1. getAllFilenames

    • Obtém uma lista de todos os nomes de arquivos no vault do Obsidian
    • Útil para descobrir quais arquivos estão disponíveis

  2. readMultipleFiles

    • Recupera o conteúdo de arquivos especificados do vault do Obsidian
    • Suporta nomes de arquivos exatos, parciais ou correspondências sem diferenciar maiúsculas de minúsculas
    • O conteúdo de cada arquivo é prefixado com '# File: filename' para identificação clara

  3. getOpenTodos

    • Recupera todos os itens TODO abertos de arquivos markdown no vault do Obsidian
    • Encontra itens de caixa de seleção não marcados (linhas contendo '- [ ] ')
    • Retorna-os com suas localizações de arquivo

Escrita

  1. updateFileContent
    • Atualiza o conteúdo de um arquivo especificado no vault do Obsidian com novo conteúdo markdown
    • Se o arquivo não existir, ele será criado
    • Cria automaticamente quaisquer diretórios necessários

Instalação e compilação

npm install obsidian-mcp-server
npm run build

Integração com Claude Desktop e Cursor

Para usar seu servidor MCP com o Claude Desktop, adicione-o à sua configuração do Claude:

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

Para o Cursor, vá para a aba MCP Cursor Settings (command + shift + J). Adicione um servidor com este comando:

node obsidian-mcp-server/build/index.js /path/to/your/vault

Comparação com Outras Soluções

Embora esta implementação seja intencionalmente leve, outras soluções como jacksteamdev/obsidian-mcp-tools oferecem uma abordagem mais rica em recursos como um plugin do Obsidian.

Este servidor independente tem a vantagem de acesso direto ao sistema de arquivos sem exigir que o aplicativo Obsidian esteja em execução.

Recursos