SnipperApp MCP

Pesquise, leia, crie e marque snippets de código no SnipperApp 3, um gerenciador de snippets nativo para macOS. 25 ferramentas cobrindo snippets, pastas, tags, workspaces, anexos e o Hub público do SnipperApp. Incluído no aplicativo: stdio, nada para instalar.

Documentação

snipper-mcp — o servidor MCP dentro do SnipperApp 3

SnipperApp 3 — code snippet manager for macOS

O SnipperApp 3 é um gerenciador nativo de snippets de código para macOS. Ele inclui seu próprio servidor Model Context Protocol, para que assistentes de IA possam pesquisar, ler, criar e organizar os snippets da sua biblioteca. Não há nada para instalar: o servidor é um binário stdio incluído no aplicativo.

Este repositório documenta a interface do servidor. O servidor em si faz parte do aplicativo (Swift, construído sobre o Swift MCP SDK).

Requisitos

Instalar no Claude Desktop (um clique)

Baixe o snipperapp-1.0.2.mcpb da última versão e abra-o; o Claude Desktop o instala como uma extensão. O pacote contém apenas um pequeno lançador (mcpb/server/index.js) que encontra o servidor dentro do SnipperApp 3 e entrega o stdio. Sem o aplicativo, ele ainda responde a initialize e tools/list (o manifesto em mcpb/server/tools.json), e cada chamada de ferramenta retorna um erro claro de não instalado; um Dockerfile executa esse modo para verificações de introspecção do registro.

Configuração (manual)

Claude Code:

claude mcp add snipper -- "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"

Claude Desktop, Cursor (.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "snipper": {
      "command": "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"
    }
  }
}

Guia completo: https://snipperapp.com/docs/mcp-integration

Ferramentas (25)

ÁreaFerramentas
Snippetssearch_snippets, get_snippet, create_snippet, update_snippet, delete_snippet
Pastaslist_folders, create_folder, update_folder, delete_folder
Tagslist_tags, create_tag, delete_tag, add_tag_to_snippet, remove_tag_from_snippet
Anexoslist_attachments, get_attachment, create_attachment, delete_attachment
Organizaçãolist_workspaces, list_storages, list_groups, list_languages
Hub (snippets públicos)search_hub, get_hub_snippet, import_from_hub

Cada ferramenta carrega um title e as anotações MCP que os clientes usam para decidir o que precisa de confirmação: as doze ferramentas de leitura são marcadas como readOnlyHint, as cinco ferramentas de exclusão/remoção de tag como destructiveHint, e as três ferramentas do Hub como openWorldHint.

O servidor lê e grava o mesmo banco de dados SQLite local que o aplicativo, então qualquer coisa que um assistente salvar aparece no SnipperApp imediatamente. Nada é enviado a um servidor; as ferramentas do Hub chamam a API pública do Hub apenas quando você as usa.

Exemplos de prompts

  • "Pesquise meus snippets pelo helper de retry-with-backoff e cole aqui."
  • "Salve esta função como um snippet no workspace Work, pasta Utilities, com a tag postgres."
  • "Liste meus snippets Swift com a tag networking."

Política de Privacidade

Política completa: https://snipperapp.com/privacy

O que o servidor coleta. Nada. O snipper-mcp não tem analytics, nem telemetria, nem relatórios de falhas próprios. O lançador MCPB neste repositório não faz nenhuma solicitação de rede — ele ou entrega o stdio ao binário incluído ou responde a tools/list a partir de um arquivo estático.

Como seus dados são usados e armazenados. O servidor lê e grava o mesmo banco de dados SQLite local que o SnipperApp 3, dentro do contêiner do próprio aplicativo no seu Mac. Snippets, pastas, tags e anexos nunca saem da sua máquina, a menos que você tenha ativado um armazenamento de sincronização: iCloud (Apple CloudKit, seu banco de dados privado — o desenvolvedor não pode lê-lo) ou GitHub Gist (sua própria conta, sob suas credenciais do GitHub).

Compartilhamento com terceiros. Nenhum pelo servidor. As três ferramentas do Hub (search_hub, get_hub_snippet, import_from_hub) chamam a API pública do SnipperApp Hub, e somente quando um assistente as invoca; elas enviam os termos de pesquisa ou o ID do snippet e nada da sua biblioteca. Nenhum conteúdo de snippet é enviado. Nada é vendido ou compartilhado com anunciantes ou corretores de dados.

Retenção de dados. Seus snippets ficam no seu Mac e permanecem até você excluí-los; excluí-los no SnipperApp 3 (ou via delete_snippet) os remove do banco de dados local e de qualquer armazenamento de sincronização que você tenha ativado. Não há cópia no lado do servidor para o desenvolvedor reter. As solicitações do Hub não estão vinculadas a uma conta e não são retidas como histórico por usuário.

Contato. support@snipper.app — para perguntas, ou para solicitar informações sobre o que é mantido sobre você e solicitar a exclusão.

Este repositório

  • mcpb/ — a extensão MCPB: manifest.json, icon.png, e o lançador server/index.js. Reconstrua com npx @anthropic-ai/mcpb pack mcpb snipperapp-<version>.mcpb.
  • server.json — a entrada para o registro oficial de MCP (mcp-publisher publish).
  • O lançador e estes documentos são licenciados sob MIT; o SnipperApp 3 e seu binário snipper-mcp incluído são proprietários.

Suporte

support@snipper.app — relatórios de bugs, solicitações de recursos e perguntas sobre privacidade. Documentação: https://snipperapp.com/docs/mcp-integration