promptz.dev

Servidor MCP promptz.dev

Acesse prompts do promptz.dev diretamente no Amazon Q Developer.

Este servidor MCP permite acessar prompts da API do promptz.dev sem copiar e colar, reduzindo a troca de contexto e o atrito no seu fluxo de trabalho de desenvolvimento.

Recursos

O Servidor MCP promptz.dev oferece duas capacidades principais:

1. Prompts - Funções executáveis para buscar e executar prompts.
2. Regras - Funções executáveis para buscar regras de projeto e, ao integrar com outras ferramentas, adicioná-las/atualizá-las no seu espaço de trabalho.

Exemplo de Uso

Uma vez que o servidor esteja conectado ao Amazon Q Developer, você pode usá-lo com linguagem natural, como:

• "Busque prompts de CLI sobre JavaScript"
• "Mostre-me o prompt chamado 'React Component Documentation'"
• "Use o prompt React Component Documentation para melhorar minha documentação"
• "Encontre regras de projeto para desenvolvimento com CDK"
• "Adicione a regra de projeto CDK Project Structure ao meu espaço de trabalho"

Instalação

Passo 1: Obtenha as Credenciais da API

1. Navegue até https://promptz.dev/mcp
2. Copie as configurações do MCP, como Chave da API, URL da API ou o trecho de configuração MCP de exemplo.

Passo 2: Instale o Servidor MCP

Abra o arquivo de configurações do cliente MCP do Amazon Q Developer localizado em ~/.aws/amazonq/mcp.json

Opção 1: Usando npx (Recomendado)

A maneira mais fácil de usar o servidor é com npx, que não requer instalação:

1. Adicione a seguinte configuração ao arquivo de configurações do cliente MCP do Amazon Q Developer:

{
  "mcpServers": {
    "promptz.dev": {
      "command": "npx",
      "args": ["-y", "@promptz/mcp"],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Opção 2: Instalação Local

1. Clone o repositório:

git clone https://github.com/cremich/promptz-mcp.git
cd promptz-mcp

2. Instale as dependências e faça o build:

npm install
npm run build

3. Adicione a seguinte configuração ao arquivo de configurações do seu cliente MCP:

{
  "mcpServers": {
    "promptz.dev": {
      "command": "node",
      "args": ["/path/to/promptz-mcp/build/index.js"],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Solução de Problemas

Se você encontrar problemas com o servidor:

1. Verifique se suas credenciais da API estão corretas
2. Garanta que o servidor esteja configurado corretamente no seu cliente MCP
3. Procure por mensagens de erro nos logs localizados em ~/.promptz/logs/mcp-server.log
4. Use o MCP Inspector para depuração:

# Run with environment variables
PROMPTZ_API_URL="your-api-url" PROMPTZ_API_KEY="your-api-key" npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Desenvolvimento

Para aqueles que desejam contribuir ou modificar o servidor:

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

Considerações de Segurança

• Este servidor fornece apenas acesso de leitura aos prompts e não implementa nenhuma operação de escrita
• As credenciais da API são armazenadas no arquivo de configuração do seu cliente MCP
• Toda comunicação com a API do promptz.dev é feita via HTTPS
• O servidor registra logs em um arquivo no seu diretório pessoal (~/.promptz/logs/mcp-server.log)