MCP Prompt Collector

Ferramentas para registrar, analisar e melhorar prompts do Claude Desktop, a fim de aprimorar habilidades de engenharia de prompt.

GitHub
3
Experimente este MCPPatrocinado

Documentação

MCP Prompt Collector

Um servidor MCP que fornece ferramentas interativas para registrar, analisar e melhorar seus prompts do Claude Desktop, ajudando você a desenvolver melhores habilidades de engenharia de prompt.

Instalação

Opção 1: Pacote NPM (Recomendado)

# Install globally
npm install -g mcp-prompt-collector

# Or install locally in your project
npm install mcp-prompt-collector

Opção 2: A partir do código-fonte

git clone https://github.com/daneb/improver-mcp.git
cd improver-mcp
npm install
npm run build

Configuração

  1. Configure o Claude Desktop

    Adicione isto ao seu ~/Library/Application Support/Claude/claude_desktop_config.json:

    Para instalação global via npm:

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "mcp-prompt-collector",
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

    Para instalação a partir do código-fonte:

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "/path/to/your/node",
      "args": ["/path/to/improver-mcp/dist/index.js"],
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

  2. Reinicie o Claude Desktop para carregar o servidor MCP

  3. Acesse o painel em http://localhost:3456

O Que Ele Faz

  • 🛠️ Ferramentas Interativas: Fornece 4 ferramentas acessíveis no Claude Desktop para análise de prompts
  • 📊 Análise de Qualidade: Pontua prompts em estrutura, clareza, contexto e eficácia
  • 💡 Insights Inteligentes: Identifica padrões e sugere melhorias específicas
  • 📈 Acompanhamento de Progresso: Mostra tendências de qualidade e evolução ao longo do tempo
  • 🌐 Painel Web: Interface limpa para visualizar histórico, análises e insights

Recursos

Funcionalidade Principal

  • ✅ Ferramentas MCP interativas para integração com Claude Desktop
  • ✅ Banco de dados SQLite para armazenamento local (sem sincronização em nuvem)
  • ✅ Pontuação de qualidade de prompts em tempo real
  • ✅ Painel web com análises
  • ✅ Geração automatizada de insights

Ferramentas Disponíveis

  • log_prompt - Registra e analisa um prompt com feedback imediato de qualidade
  • improve_prompt - Obtém sugestões específicas para melhorar qualquer prompt
  • get_prompt_insights - Visualiza análises e padrões do seu histórico de prompts
  • view_stats - Exibe estatísticas abrangentes e tendências de qualidade

Mecanismo de Análise

  • Pontuação de Qualidade: Nota de 0 a 10 baseada em estrutura, clareza e completude
  • Detecção de Complexidade: Categoriza prompts como simples, moderados ou complexos
  • Sugestões de Técnicas: Recomenda técnicas ideais de prompting
  • Detecção de Problemas: Identifica ambiguidade, falta de contexto, viés, etc.

Recursos do Painel

  • Histórico de prompts com busca e filtros
  • Tendências de qualidade ao longo do tempo
  • Gráficos de distribuição de complexidade
  • Visão geral da atividade recente
  • Insights acionáveis para melhoria

Uso

No Claude Desktop

Quando o servidor MCP estiver em execução, você terá acesso a estas ferramentas no Claude Desktop:

log_prompt
- Use: Log and analyze any prompt
- Example: "log_prompt" with your prompt text
- Returns: Quality score, complexity, and improvement suggestions

improve_prompt  
- Use: Get specific suggestions for a prompt
- Example: "improve_prompt" with your prompt and optional goal
- Returns: Detailed analysis and actionable improvement recommendations

get_prompt_insights
- Use: View patterns and insights from your prompt history
- Example: "get_prompt_insights" optionally filtered by category
- Returns: Analytics on your prompting patterns and common issues

view_stats
- Use: See comprehensive statistics and trends
- Example: "view_stats" for last 30 days (configurable)
- Returns: Total prompts, quality trends, complexity breakdown

Comandos de Desenvolvimento

# Build and run
npm run build                       # Build TypeScript
npm run dev                         # Development mode with auto-reload
npm start                          # Start the MCP server

# Code quality
npm test                           # Run tests
npm run lint                       # Check code style
npm run format                     # Format code

Como Funciona

  1. Integração MCP: Registra-se como servidor MCP no Claude Desktop
  2. Ferramentas Interativas: Fornece 4 ferramentas acessíveis pela interface do Claude Desktop
  3. Registro Manual: Usuários registram prompts explicitamente usando a ferramenta log_prompt
  4. Análise: Pontua qualidade, detecta padrões, identifica melhorias
  5. Armazenamento: Salva tudo localmente no banco de dados SQLite
  6. Insights: Gera sugestões personalizadas com base nos seus padrões
  7. Painel: Fornece interface web para visualizar análises e histórico

Configuração

A configuração padrão é armazenada em ~/.mcp-prompt-collector/config/settings.json:

{
  "name": "mcp-prompt-collector",
  "capabilities": {
    "intercept": true,
    "modify": false,
    "store": true
  },
  "settings": {
    "enhancePrompts": false,
    "storageLocation": "~/.mcp-prompt-collector/data",
    "dashboardPort": 3456,
    "analysisLevel": "detailed",
    "retentionDays": 90
  }
}

Armazenamento de Dados

Todos os dados são armazenados localmente no banco de dados SQLite:

  • Localização: ~/.mcp-prompt-collector/data/prompt_history.db
  • Privacidade: Sem sincronização em nuvem, controle local completo
  • Retenção: Limpeza configurável após N dias
  • Exportação: Capacidades completas de exportação de dados

Desenvolvimento

# Clone and setup
git clone <repo-url>
cd mcp-prompt-collector
npm install

# Development workflow
npm run dev        # Watch mode
npm run build      # Production build
npm test          # Run tests
npm run lint      # Code quality

# Testing
npm run test:unit        # Unit tests
npm run test:integration # Integration tests

Arquitetura

  • Manipulador de Protocolo MCP: Comunica-se com o Claude Desktop
  • Gerenciador de Armazenamento: Operações do banco de dados SQLite
  • Mecanismo de Análise: Pontuação de qualidade de prompts e insights
  • Servidor do Painel: Interface web Express.js
  • Trabalhador em Segundo Plano: Análise e limpeza agendadas

Privacidade e Segurança

  • ✅ Somente Local: Todos os dados permanecem na sua máquina
  • ✅ Sem Sincronização em Nuvem: Zero transmissão externa de dados
  • ✅ Controle do Usuário: Propriedade completa dos dados e exportação
  • ✅ Transparente: Código aberto e auditável

Requisitos

  • Node.js: 18+
  • Claude Desktop: Versão mais recente com suporte a MCP
  • macOS: Suporte principal (Windows/Linux em breve)

Solução de Problemas

O servidor não inicia

  • Verifique se a porta 3456 está disponível
  • Verifique a configuração MCP do Claude Desktop
  • Execute mcp-prompt-collector status para diagnósticos

Nenhum prompt aparecendo no painel

  • Certifique-se de estar usando a ferramenta log_prompt no Claude Desktop
  • Os prompts não são capturados automaticamente - você deve registrá-los manualmente
  • Verifique se as ferramentas do servidor MCP estão disponíveis no Claude Desktop

O painel não carrega

  • Verifique se o servidor está rodando na porta correta
  • Tente uma porta diferente com setup --port 3457
  • Verifique o console do navegador para erros

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes