Servidor MCP promptz.dev

Acceda a las indicaciones de promptz.dev directamente dentro de Amazon Q Developer.

Este servidor MCP permite acceder a las indicaciones de la API promptz.dev sin copiar y pegar, lo que reduce el cambio de contexto y la fricción en el flujo de trabajo de desarrollo.

Características

El servidor MCP promptz.dev proporciona dos capacidades principales:

1. Avisos : funciones ejecutables para buscar y ejecutar avisos.

2. Reglas : Funciones ejecutables para buscar reglas del proyecto y, al integrarlas con otras herramientas, agregarlas o actualizarlas en su espacio de trabajo.

Related MCP server: prompts.chat MCP Server

Ejemplo de uso

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

• Buscar indicaciones de la CLI sobre JavaScript

• "Muéstrame el mensaje llamado 'Documentación del componente React'"

• "Utilice la solicitud de documentación de componentes de React para mejorar mi documentación"

• Encontrar reglas de proyecto para el desarrollo de CDK

• "Agregar la regla de proyecto Estructura del proyecto CDK a mi espacio de trabajo"

Instalación

Paso 1: Obtener credenciales de API

1. Vaya a https://promptz.dev/mcp

2. Copie la configuración de MCP, como la clave API, la URL de API o el fragmento de configuración de MCP de muestra.

Paso 2: Instalar el servidor MCP

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

Opción 1: Usar npx (recomendado)

La forma más sencilla de utilizar el servidor es con npx, que no requiere instalación:

1. Agregue la siguiente configuración al archivo de configuración de su 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

1. Clonar el repositorio:

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

2. Instalar dependencias y compilar:

npm install
npm run build

3. Agregue la siguiente configuración al archivo de configuración de su 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 encuentra problemas con el servidor:

1. Comprueba que tus credenciales de API sean correctas

2. Asegúrese de que el servidor esté configurado correctamente en su cliente MCP

3. Busque mensajes de error en los registros ubicados en ~/.promptz/logs/mcp-server.log

4. Utilice el Inspector 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 su 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 las indicaciones y no implementa ninguna operación de escritura.

• Las credenciales de API se almacenan en el archivo de configuración de su cliente MCP

• Toda la comunicación con la API promptz.dev se realiza a través de HTTPS

• El servidor registra en un archivo en su directorio de inicio (~/.promptz/logs/mcp-server.log)