Advanced-starfruit874/second-brain-cloudflare

O que second-brain-cloudflare faz?

Armazene e recupere conhecimento entre ferramentas de IA com um servidor MCP implantado no Cloudflare Workers.

Visão Geral

Esta skill fornece um servidor MCP (Model Context Protocol) executado no Cloudflare Workers, atuando como um segundo cérebro para agentes de IA. Ele expõe operações CRUD simples para gerenciar notas, trechos de código, links e ideias, permitindo que diferentes ferramentas de IA compartilhem e acessem um repositório comum de conhecimento.

Plataformas suportadas:

• Claude Code (cliente MCP)
• Cursor (agente)
• Qualquer cliente MCP ou ferramenta com capacidade HTTP

Como funciona

1. O servidor MCP é implantado como um Cloudflare Worker.
2. Os dados são armazenados no Workers KV, proporcionando persistência global, baixa latência e sem necessidade de gerenciar bancos de dados.
3. As ferramentas de IA se comunicam com o servidor via JSON-RPC sobre HTTPS.
4. Operações disponíveis: create, read, update, delete e search.

Pré-requisitos

• Node.js 18+
• Conta no Cloudflare
• Wrangler CLI configurado

Implantação

# Clone o repositório
git clone https://github.com/advanced-starfruit874/second-brain-cloudflare.git
cd second-brain-cloudflare

# Instale as dependências
npm install

# Configure as variáveis de ambiente (se necessário)
# Edite wrangler.toml

# Faça deploy para o Cloudflare Workers
npx wrangler deploy

Configuração do Cliente

Para conectar seu agente de IA a este servidor MCP, configure o cliente MCP com a URL do seu Worker implantado.

Claude Code

Adicione ao seu arquivo de configuração MCP (~/.claude/mcp.json):

{
  "mcpServers": {
    "second-brain-cloudflare": {
      "url": "https://seu-worker.sua-subdominio.workers.dev",
      "transport": "http"
    }
  }
}

Cursor

Nas configurações do Cursor, vá para a seção Agente e adicione um novo servidor MCP com a URL apropriada.

Uso

Uma vez conectado, seu agente de IA poderá usar ferramentas como:

• criar_nota(titulo, conteudo, tags?) – Cria uma nova nota.
• buscar_notas(consulta) – Pesquisa notas existentes.
• obter_nota(id) – Recupera uma nota pelo ID.
• atualizar_nota(id, dados) – Atualiza campos de uma nota.
• excluir_nota(id) – Remove uma nota.

Exemplo

> Nota: Exemplo de segundo cérebro
> Conteúdo: Lembrar de implementar autenticação JWT no próximo sprint.
Tags: #desenvolvimento #backend #seguranca

O agente pode salvar esta nota e depois recuperá-la durante uma sessão futura.

Contribuindo

Contribuições são bem-vindas! Abra uma issue ou pull request no repositório GitHub.

Licença

MIT