promptz.dev

Acceder

Documentación

Servidor MCP de promptz.dev

Accede a prompts desde promptz.dev directamente dentro de Amazon Q Developer.

Este servidor MCP permite acceder a prompts desde la API de promptz.dev sin copiar y pegar, reduciendo el cambio de contexto y la fricción en tu flujo de trabajo de desarrollo.

Características

El servidor MCP de promptz.dev proporciona dos capacidades principales:

Prompts - Funciones ejecutables para buscar y ejecutar prompts.
Reglas - Funciones ejecutables para buscar reglas de proyecto y, mediante la integración con otras herramientas, agregarlas/actualizarlas en tu espacio de trabajo.

Ejemplo de Uso

Una vez que el servidor esté conectado a Amazon Q Developer, puedes usarlo con lenguaje natural como:

"Busca prompts de CLI sobre JavaScript"
"Muéstrame el prompt llamado 'React Component Documentation'"
"Usa el prompt de React Component Documentation para mejorar mi documentación"
"Encuentra reglas de proyecto para desarrollo con CDK"
"Agrega la regla de proyecto CDK Project Structure a mi espacio de trabajo"

Instalación

Paso 1: Obtén Credenciales de API

Navega a https://promptz.dev/mcp
Copia la configuración de MCP como la clave de API, la URL de la API o el fragmento de configuración de muestra de MCP.

Paso 2: Instala el Servidor MCP

Abre el archivo de configuración del cliente MCP de Amazon Q Developer ubicado en ~/.aws/amazonq/mcp.json

Opción 1: Usando npx (Recomendado)

La forma más fácil de usar el servidor es con npx, que no requiere instalación:

Agrega la siguiente configuración al archivo de configuración del cliente MCP de 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": []
    }
  }
}

Opción 2: Instalación Local

Clona el repositorio:

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

Instala las dependencias y compila:

npm install
npm run build

Agrega la siguiente configuración al archivo de configuración de tu 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": []
    }
  }
}

Solución de Problemas

Si encuentras problemas con el servidor:

Verifica que tus credenciales de API sean correctas
Asegúrate de que el servidor esté configurado correctamente en tu cliente MCP
Busca mensajes de error en los registros ubicados en ~/.promptz/logs/mcp-server.log
Usa el Inspector de MCP para depurar:

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

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.

Desarrollo

Para aquellos que quieran contribuir o modificar el servidor:

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

Consideraciones de Seguridad

Este servidor solo proporciona acceso de lectura a los prompts y no implementa ninguna operación de escritura
Las credenciales de API se almacenan en el archivo de configuración de tu cliente MCP
Toda la comunicación con la API de promptz.dev se realiza mediante HTTPS
El servidor registra en un archivo en tu directorio de inicio (~/.promptz/logs/mcp-server.log)