Servidor Obsidian MCP

O que faz o servidor “Obsidian” MCP?

O Servidor Obsidian MCP é um conector que permite ao Claude Desktop—ou a qualquer cliente Model Context Protocol (MCP)—ler e pesquisar diretórios contendo notas em Markdown, como aquelas encontradas em um cofre Obsidian. Este servidor faz a ponte entre assistentes de IA e suas bases de conhecimento pessoais ou de equipe armazenadas em formato Markdown, facilitando o acesso, a pesquisa e o uso das notas dentro dos fluxos de trabalho de desenvolvimento. Ao integrar-se a fontes externas de dados como o Obsidian, o servidor capacita ferramentas de IA a executar tarefas como busca de informações, recuperação de notas específicas ou sumarização de conteúdo, aumentando assim a produtividade e a gestão de conhecimento para desenvolvedores e trabalhadores do conhecimento.

Lista de Prompts

Nenhum modelo de prompt foi explicitamente mencionado na documentação disponível.

Lista de Recursos

Nenhum recurso específico é detalhado na documentação fornecida.

Lista de Ferramentas

Pela documentação e imagens disponíveis, após a instalação, as seguintes ferramentas são listadas (embora não descritas no código):

• Ler Nota: Permite ler o conteúdo de uma nota específica no cofre Obsidian.
• Pesquisar Notas: Habilita a pesquisa de notas dentro do cofre com base em palavras-chave ou consultas.

Nota: Os nomes e descrições exatos das ferramentas foram inferidos da documentação e imagens disponíveis; mais detalhes não foram especificados.

Casos de Uso deste Servidor MCP

• Gestão de Conhecimento Pessoal: Pesquise, leia e recupere informações de cofres pessoais do Obsidian usando o Claude Desktop, tornando suas notas acessíveis a LLMs para sumarização ou respostas a perguntas.
• Pesquisa de Documentação de Equipe: Integre diretórios Markdown compartilhados como recursos pesquisáveis para membros da equipe ou assistentes de IA, melhorando o compartilhamento de conhecimento e onboarding.
• Assistência Contextual de IA: Forneça informações relevantes das suas notas como contexto para LLMs, aumentando a relevância e precisão das respostas geradas por IA durante o desenvolvimento ou pesquisa.
• Sumarização Automatizada de Notas: Use IA para resumir notas ou documentos extensos dentro do seu cofre Obsidian, economizando tempo em sumarizações manuais.

Como configurar

Windsurf

1. Certifique-se de que Node.js e Windsurf estão instalados.
2. Abra seu arquivo de configuração do Windsurf.
3. Adicione o seguinte à seção mcpServers:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Salve o arquivo e reinicie o Windsurf.
5. Verifique se o servidor MCP está em execução e acessível.

Claude

1. Certifique-se de que Claude Desktop e Node.js estão instalados.
2. Instale o Obsidian MCP usando o Smithery:

   npx @smithery/cli install mcp-obsidian --client claude
   

3. Reinicie o Claude Desktop.
4. Confirme que as ferramentas do Obsidian MCP aparecem na interface do Claude Desktop.

Cursor

1. Certifique-se de que Node.js e Cursor estão instalados.
2. Abra seu arquivo de configuração do Cursor.
3. Adicione o servidor Obsidian MCP conforme segue:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Salve e reinicie o Cursor.
5. Verifique a listagem de ferramentas do Cursor para o servidor Obsidian MCP.

Cline

1. Instale o Node.js e o Cline.
2. Edite seu arquivo de configuração do Cline.
3. Inclua o servidor Obsidian MCP:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Salve a configuração e reinicie o Cline.
5. Valide a configuração verificando o Obsidian MCP na interface.

Protegendo Chaves de API

Se o servidor Obsidian MCP ou seu cofre exigirem autenticação ou chaves de API, utilize variáveis de ambiente para segurança:

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Após configurar, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “obsidian” para o nome real do seu servidor MCP e substituir a URL pela do seu próprio servidor MCP.

Visão Geral

Com base no exposto, o Servidor Obsidian MCP é simples e fácil de configurar para pesquisa e recuperação de cofres Obsidian, mas carece de modelos de prompt detalhados, definições explícitas de recursos e recursos MCP avançados como amostragem ou raízes. Ainda assim, fornece ferramentas essenciais para tornar notas do Obsidian acessíveis à IA.

Pontuação MCP

Dada a simplicidade e clareza de propósito, facilidade de instalação e utilidade específica para usuários do Obsidian, eu avaliaria este servidor MCP em 6/10. Ele é bem adequado ao seu caso de uso, mas carece de recursos MCP avançados e profundidade de documentação para maior extensibilidade.