GistPad MCP

Gerencie e compartilhe conhecimento pessoal, notas diárias e prompts reutilizáveis usando GitHub Gists.

GitHub
208
Experimente este MCPPatrocinado

Documentação

📓 GistPad MCP

Um servidor MCP para gerenciar e compartilhar seu conhecimento pessoal, notas diárias e prompts reutilizáveis via GitHub Gists. Ele é um complemento à extensão do VS Code do GistPad e ao GistPad.dev (para web/mobile), que permite acessar e editar seus gists de qualquer produto de IA habilitado para MCP (por exemplo, GitHub Copilot, Claude Desktop).

🏃 Como começar

  1. Usando VS Code?

    1. Instale a extensão do GistPad e recarregue o VS Code

      Nota: isso requer VS Code 1.101.0 ou superior. Se você estiver em uma versão mais antiga, está na hora de atualizar!

    2. Abra a guia GistPad e faça login com sua conta do GitHub. Depois disso, você pode começar a usar o GistPad no chat do Copilot (no modo Agent) sem fazer nenhuma configuração extra ou gerenciamento de tokens 💪

  2. Outros clientes MCP...

    1. Gere um token de acesso pessoal que inclua somente o escopo gist: https://github.com/settings/tokens/new

    2. Adicione o equivalente ao seguinte ao arquivo de configuração MCP do seu cliente (ou via uma interface gráfica/TUI "Adicionar servidor MCP"):

      {
  "mcpServers": {
    "gistpad": {
      "command": "npx",
      "args": ["-y", "gistpad-mcp"],
      "env": {
        "GITHUB_TOKEN": "<YOUR_PAT>"
      }
    }
  }
}

Assim que seu cliente estiver configurado, você pode começar a se divertir com gists + MCP! 🥳 Por exemplo, tente coisas como...

  1. Explorando conteúdo

    • How many gists have I edited this month?
    • What's the summary of my <foo> gist?

  2. Criando conteúdo

    • Create a new gist about <foo>
    • Update my <foo> gist to call out <bar>

  3. Todos diários

    • What are my unfinished todos for today?
    • Add a new todo for <foo>

  4. Colaboração

    • Add a comment to the <foo> gist saying <bar>
    • Give me a share URL for the <foo> gist
    • View my starred gists

  5. Organização de gists

    • Archive my gist about <foo>
    • Add a new <foo> file to the <bar> gist and migrate the <baz> content into it

  6. Prompts reutilizáveis

    • Create a new prompt that searches the web ofor a specified manga series and then provides a summary about it
    • Delete my prompt about <foo>

🛠️ Ferramentas incluídas

Gerenciamento de gists

  • list_gists - Lista todos os seus gists (excluindo notas diárias e gists arquivados).
  • get_gist - Obtém o conteúdo de um gist pelo ID.
  • create_gist - Cria um novo gist com uma descrição especificada e conteúdos iniciais de arquivo.
  • delete_gist - Exclui um gist pelo ID.
  • update_gist_description - Atualiza a descrição de um gist pelo ID.
  • duplicate_gist - Cria uma cópia de um gist existente com todos os seus arquivos.
  • refresh_gists - Recarrega suas listas de gists, ignorando qualquer dado em cache.

Gerenciamento de arquivos

  • update_gist_file - Atualiza o conteúdo de um arquivo específico em um gist.
  • add_gist_file - Adiciona um novo arquivo a um gist existente.
  • delete_gist_file - Exclui um arquivo de um gist.
  • rename_gist_file - Renomeia um arquivo existente dentro de um gist.
  • edit_gist_file - Faz edições direcionadas de localizar e substituir em um arquivo de gist.

Comentários

  • list_gist_comments - Lista todos os comentários de um gist especificado.
  • add_gist_comment - Adiciona um novo comentário a um gist.
  • edit_gist_comment - Atualiza o conteúdo de um comentário existente.
  • delete_gist_comment - Exclui um comentário de um gist.

🛠️ Ferramentas opcionais

Os seguintes conjuntos de ferramentas estão desabilitados por padrão para manter a superfície de ferramentas mínima. Ative-os passando o respectivo sinalizador da CLI.

Notas diárias (--daily)

  • get_todays_note - Obtém ou cria a nota diária de hoje.
  • update_todays_note - Atualiza o conteúdo da nota diária de hoje.
  • list_daily_notes - Lista todas as suas notas diárias.
  • get_daily_note - Obtém o conteúdo de uma nota diária específica por data.
  • delete_daily_note - Exclui uma nota diária específica por data.

Favoritos (--starred)

  • list_starred_gists - Lista todos os seus gists favoritados.
  • star_gist - Favorita um gist específico pelo ID.
  • unstar_gist - Desfavorita um gist favoritado pelo ID.

Arquivamento (--archived)

  • list_archived_gists - Lista todos os seus gists arquivados.
  • archive_gist - Arquivar um dos seus gists.
  • unarchive_gist - Desarquivar um gist arquivado.

Prompts (--prompts)

  • list_gist_prompts - Lista os prompts da sua coleção de prompts.
  • add_gist_prompt - Adiciona um novo prompt à sua coleção de prompts.
  • delete_gist_prompt - Exclui um prompt da sua coleção.

📁 Recursos incluídos

Além das ferramentas acima, o servidor MCP do GistPad também expõe seus gists como recursos (usando o esquema de URI gist:///), o que permite que os clientes os leiam sem exigir execução de ferramentas.

Quando você adiciona/exclui/duplica um gist ou altera a descrição de um gist, uma notificação é fornecida aos clientes MCP, indicando que a lista de recursos mudou. E se o seu cliente MCP suportar assinaturas de recursos, você pode se inscrever em um gist específico e ser notificado quando ele for atualizado.

Além disso, para clientes MCP que suportam modelos de recursos, o GistPad também expõe um recurso em gist:///{gistId}/comments, que permite consultar os comentários de um gist (sem precisar executar a ferramenta list_gist_comments).

Configuração de recursos

Se você quiser expor seus gists arquivados, gists favoritados e/ou notas diárias como recursos, basta atualizar a configuração do seu servidor MCP para passar os sinalizadores --archived, --starred e/ou --daily para a CLI gistpad-mcp.

💬 Prompts reutilizáveis

O GistPad permite que você crie e gerencie prompts parametrizados/reutilizáveis que são armazenados como arquivos Markdown em um gist. Você pode gerenciar prompts usando a ferramenta add_prompt e delete_prompt, simplesmente pedindo ao seu cliente MCP para criar/excluir um prompt, com os conteúdos/argumentos especificados que você desejar.

Nos bastidores, os prompts são armazenados como arquivos Markdown em um gist chamado 💬 Prompts (que é criado automaticamente pela ferramenta add_prompt). Os arquivos de prompt incluem o prompt como corpo e, opcionalmente, uma descrição e argumentos usando front-matter. E se o prompt fizer uso de argumentos, o corpo do prompt deve incluir espaços reservados {{argument}}, que serão substituídos quando o cliente MCP o recuperar.

💻 Referência da CLI

A CLI gistpad-mcp aceita os seguintes sinalizadores opcionais:

  • --archived - Ativa ferramentas de arquivamento e inclui gists arquivados nos recursos
  • --starred - Ativa ferramentas de favoritos e inclui gists favoritados nos recursos
  • --daily - Ativa ferramentas de notas diárias e inclui notas diárias nos recursos
  • --prompts - Ativa ferramentas de prompts e manipuladores de prompts MCP
  • --markdown - Filtra gists para apenas aqueles compostos por arquivos Markdown

🧰 Solução de problemas

  • Não está vendo um gist na sua lista? O servidor MCP do GistPad armazena em cache sua lista de gists e a atualiza 1) sempre que você faz uma alteração por meio do servidor MCP, ou 2) a cada hora. No entanto, se você adicionar/editar/excluir um gist usando um cliente externo, talvez seja necessário dizer ao GistPad MCP para se atualizar (supondo que ele ainda não tenha feito sua atualização horária). Você pode fazer isso acionando a ferramenta refresh_gists (por exemplo, executando #refresh_gists no chat do Copilot no VS Code).