Obsidian Nexus

Conecta-se diretamente ao seu cofre local do Obsidian para gerenciamento de notas e organização de dados sem interrupções.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Obsidian Nexus - Servidor MCP do Obsidian

Conecte o Claude Desktop diretamente ao seu cofre do Obsidian para gerenciamento contínuo de notas e organização inteligente de dados familiares.

Visão Geral

O Obsidian Nexus é um servidor Model Context Protocol (MCP) que dá ao Claude Desktop acesso direto ao seu cofre do Obsidian. Basta configurar o caminho do seu cofre e começar a gerenciar as notas, tarefas e base de conhecimento da sua família por meio de conversas naturais com o Claude.

Principais Recursos

📝 Acesso Direto ao Cofre

  • Leia, escreva e acrescente conteúdo a qualquer nota do seu cofre
  • Criação automática de pastas e organização
  • Suporte completo a Markdown com vinculação do Obsidian

🔍 Busca Inteligente

  • Pesquise em todas as notas com trechos contextuais
  • Liste notas por diretório ou padrão
  • Encontre informações instantaneamente por meio de consultas naturais

🏠 Organização Familiar

  • Estrutura de pastas pré-configurada para dados familiares
  • Suporte para Notas Diárias, membros da família e Temas
  • Zero configuração - basta apontar para o seu cofre

🛡️ Simples e Confiável

  • Sem necessidade de chaves de API - o Claude Desktop faz o processamento de IA
  • Operações de arquivo somente locais para privacidade
  • Criação automática da estrutura do cofre

Início Rápido

1. Instalação

git clone https://github.com/nkriman/obsidian-nexus
cd obsidian-nexus
npm install

2. Configuração

Edite config.yaml e defina o caminho do seu cofre:

# Update this path to your Obsidian vault
vault_path: "/Users/yourname/Documents/Obsidian/YourVault"

# Optional: Configure family members
family:
  people: ["Nick", "Sarah", "Leo", "Mia"]

3. Adicione ao Claude Desktop

Adicione às suas configurações do MCP (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian-nexus": {
      "command": "node",
      "args": ["/path/to/obsidian-nexus/src/index.js"]
    }
  }
}

4. Reinicie o Claude Desktop

Pronto! O Claude agora pode acessar seu cofre do Obsidian.

Ferramentas Disponíveis

📖 read_note

Leia qualquer nota do seu cofre:

read_note path="Family/Leo.md"

✏️ write_note

Crie ou atualize uma nota:

write_note path="Daily Notes/2025-06-22.md" content="# Today's Activities..."

➕ append_to_note

Adicione conteúdo a uma nota existente:

append_to_note path="Family/Leo.md" content="## School Update\nGot an A on math test!"

📚 list_notes

Liste todas as notas ou pesquise por diretório:

list_notes directory="Family"

🔍 search_notes

Pesquise conteúdo em todo o seu cofre:

search_notes query="doctor appointment"

📊 vault_status

Verifique a configuração e as estatísticas do cofre.

Estrutura do Cofre

O Obsidian Nexus cria automaticamente esta estrutura organizada:

YourVault/
├── Daily Notes/
│   └── 2025-06-22.md          # Daily family logs
├── Family/
│   ├── Leo.md                 # Individual family member notes
│   ├── Mia.md
│   └── Nick.md
├── Themes/
│   ├── Medical.md             # Topical organization
│   ├── School.md
│   └── Travel.md
├── inbox/
│   └── quick-notes.md         # Temporary storage
└── config/
    └── obsidian-nexus.yaml    # Local configuration

Exemplos de Interação

📝 Registro Diário da Família

"Crie uma nota para hoje sobre o treino de futebol do Leo e a aula de piano da Mia"

O Claude irá:

  1. Criar Daily Notes/2025-06-22.md
  2. Adicionar conteúdo estruturado sobre ambas as atividades
  3. Vincular às notas individuais dos membros da família

🔍 Encontrando Informações

"Quando foi a última consulta médica do Leo e o que o médico disse?"

O Claude irá:

  1. Pesquisar em todas as notas por "Leo" + "médico"
  2. Encontrar trechos relevantes com contexto
  3. Fornecer um resumo com citações das fontes

📊 Organizando Conhecimento

"Ajude-me a organizar todas as informações médicas espalhadas pelas minhas notas"

O Claude irá:

  1. Pesquisar conteúdo relacionado à saúde
  2. Criar notas de tema organizadas
  3. Atualizar as notas dos membros da família com links adequados

Opções de Configuração

Configuração Básica

vault_path: "/path/to/your/vault"    # Required: Your Obsidian vault path

family:
  people: ["Name1", "Name2"]         # Optional: Family member tracking

templates:
  daily_note: "Daily Notes/{{date}}.md"
  person_note: "Family/{{person}}.md"
  theme_note: "Themes/{{theme}}.md"

Opções Avançadas

structure:
  create_folders: true    # Auto-create folder structure
  use_daily_notes: true   # Enable daily notes pattern
  backup_files: true      # Keep backups of modified files

Casos de Uso

🏠 Gestão da Vida Familiar

  • Acompanhe atividades, consultas e marcos das crianças
  • Organize registros médicos e comunicações escolares
  • Crie uma base de conhecimento familiar pesquisável

📚 Gestão de Conhecimento Pessoal

  • Organização e síntese de notas de pesquisa
  • Documentação e planejamento de projetos
  • Registros de aprendizado e materiais de estudo

💼 Trabalho e Projetos

  • Notas de reuniões e itens de ação
  • Documentação de projetos e acompanhamento de progresso
  • Compartilhamento e colaboração de conhecimento em equipe

Benefícios em Relação ao Obsidian Manual

🤖 Organização com IA

  • O Claude entende contexto e relacionamentos
  • Estrutura e vinculação automáticas de notas
  • Síntese inteligente de conteúdo

⚡ Velocidade e Eficiência

  • Comandos em linguagem natural em vez de cliques manuais
  • Busca instantânea em todo o cofre
  • Operações em lote e sugestões inteligentes

🔗 Integração Perfeita

  • Funciona junto com o aplicativo Obsidian
  • Preserva todos os recursos e plugins do Obsidian
  • Markdown padrão - sem dependência de fornecedor

Solução de Problemas

Problemas Comuns

"Arquivo de configuração não encontrado"

  • Certifique-se de que config.yaml existe na raiz do projeto
  • Verifique se o caminho do cofre é absoluto e correto

"O caminho do cofre não existe"

  • Verifique se o caminho aponta para um diretório válido
  • Crie o diretório se ele não existir

"Permissão negada"

  • Verifique as permissões de arquivo/pasta no diretório do cofre
  • Certifique-se de que o aplicativo Obsidian não está bloqueando arquivos

Testando Sua Configuração

# Test the server directly
node src/index.js

# Check configuration
vault_status

Privacidade e Segurança

  • Processamento somente local - sem dependências de nuvem
  • Operações baseadas em arquivos - arquivos Markdown padrão
  • Sem necessidade de chaves de API - o Claude Desktop cuida do processamento de IA
  • Código aberto - transparência total do código

Roteiro

  • Sistema avançado de modelos
  • Suporte a integração de plugins
  • Gerenciamento de múltiplos cofres
  • Sincronização em tempo real com o aplicativo Obsidian
  • Busca avançada com tags e metadados
  • Utilitários de exportação/importação

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Adicione testes para novas funcionalidades
  4. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Obsidian Nexus - Seu cofre, a inteligência do Claude, harmonia perfeita.