LutoLabs/mytwin-mcp

O que mytwin-mcp faz?

Um banco de dados RAG pessoal e mecanismo de busca semântica que você constrói diretamente do chat de IA. Armazena seu conhecimento, tom de voz e habilidades, para que o Claude crie trabalhos que soem como você.

Visão Geral

O MyTwin MCP permite que você construa e consulte um banco de dados pessoal de conhecimento, estilo e habilidades. Ele funciona como um servidor MCP (Model Context Protocol) que pode ser conectado ao Claude Desktop ou a terminais compatíveis com MCP.

Como Funciona

1. Armazenamento de Conhecimento: Adicione notas, artigos, exemplos de código, ou qualquer texto que represente seu conhecimento e estilo.
2. Indexação Semântica: O sistema gera embeddings para cada documento, permitindo buscas por similaridade semântica.
3. Consulta Contextual: Durante uma conversa com o Claude, você pode invocar buscas que retornam informações relevantes para o contexto atual.
4. Personalização: O Claude utiliza os resultados para adaptar seu tom, estilo e conteúdo ao seu perfil único.

Pré-requisitos

• Claude Desktop ou um terminal com suporte a MCP (ex: Claude Code, Cursor, Codex).
• Node.js (versão 18 ou superior) para executar o servidor MCP.
• Chave de API para o modelo de embeddings (ex: OpenAI, Cohere).

Instalação

1. Clone o repositório:

   git clone https://github.com/LutoLabs/mytwin-mcp.git
   cd mytwin-mcp
   

2. Instale as dependências:

   npm install
   

3. Configure as variáveis de ambiente. Crie um arquivo .env com:

   EMBEDDING_API_KEY=sua_chave_aqui
   DATA_DIR=./data
   

4. Inicie o servidor MCP:

   npm start
   

Configuração no Claude Desktop

Para conectar ao Claude Desktop, adicione o seguinte ao seu arquivo de configuração claude_desktop_config.json:

{
  "mcpServers": {
    "mytwin": {
      "command": "node",
      "args": ["/caminho/para/mytwin-mcp/index.js"],
      "env": {
        "EMBEDDING_API_KEY": "sua_chave_aqui",
        "DATA_DIR": "./data"
      }
    }
  }
}

Comandos Disponível

• search <query>: Realiza uma busca semântica por documentos relevantes.
• add <document>: Adiciona um novo documento ao banco de dados.
• list: Lista todos os documentos armazenados.
• delete <id>: Remove um documento específico.

Exemplos de Uso

Adicionar conhecimento pessoal:

Usuário: Adicione que meu estilo de código prefere async/await em vez de promessas encadeadas.
Claude: Documento adicionado com sucesso.

Buscar informações durante uma conversa:

Usuário: Pesquise meu estilo de codificação.
Claude: Encontrei um documento sobre seu estilo de código: 'Prefere async/await em vez de promessas encadeadas'. Vou aplicar isso à resposta.

Suporte a Plataformas

• Claude Desktop
• Claude Code (terminal)
• Cursor (IDE)
• Codex (CLI)
• Qualquer cliente MCP compatível

Licença

Este projeto está licenciado sob a licença MIT.