Servidor MCP promptz.dev

Acceda a las indicaciones de promptz.dev directamente desde sus asistentes de IA.

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:

Herramientas : funciones ejecutables que permiten a los asistentes de IA interactuar con la API promptz.dev
Avisos : acceso directo a avisos como plantillas de avisos de MCP

API de herramientas y avisos

Herramientas

El servidor expone las siguientes herramientas a través del protocolo MCP:

`list_prompts`

Enumera los mensajes disponibles en la plataforma promptz.dev.

Esquema de entrada:

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination token for fetching the next set of results"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter prompts by tags (e.g. ['CLI', 'JavaScript'])"
    }
  }
}

Ejemplo de uso:

// List all prompts
list_prompts()

// List prompts with pagination
list_prompts({ "cursor": "next-page-token" })

// Filter prompts by tags
list_prompts({ "tags": ["JavaScript", "CLI"] })

Formato de respuesta:

{
  "prompts": [
    {
      "name": "React Component Generator",
      "description": "Generates React components based on specifications",
      "tags": ["React", "JavaScript", "Frontend"]
    }
    // More prompts...
  ],
  "nextCursor": "optional-pagination-token"
}

`get_prompt`

Recupera un mensaje específico por nombre.

Esquema de entrada:

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the prompt to retrieve"
    }
  },
  "required": ["name"]
}

Ejemplo de uso:

get_prompt({ "name": "React Component Generator" })

Formato de respuesta:

{
  "name": "React Component Generator",
  "description": "Generates React components based on specifications",
  "instruction": "Create a React component that...",
  "tags": ["React", "JavaScript", "Frontend"]
}

API de indicaciones

El servidor también implementa la capacidad MCP Prompts, que permite a los asistentes de IA acceder directamente a las indicaciones como plantillas:

Lista de indicaciones : devuelve las indicaciones disponibles en formato de plantilla de indicaciones de MCP
Obtener aviso : devuelve un aviso específico como una plantilla de aviso MCP que el asistente de IA puede usar directamente

Instalación

Paso 1: Obtener credenciales de API

Vaya a https://promptz.dev/mcp
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

Opción 1: Usar npx (recomendado)

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

Agregue la siguiente configuración al archivo de configuración de su cliente MCP:

{
  "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

Clonar el repositorio:

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

Instalar dependencias y compilar:

npm install
npm run build

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": []
    }
  }
}

Paso 3: Configure su cliente MCP

Escritorio de Claude

Agregue la configuración del servidor al archivo de configuración de Claude Desktop:

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas : %APPDATA%/Claude/claude_desktop_config.json

Si el archivo no existe, créelo con el siguiente contenido:

{
  "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": []
    }
  }
}

Otros clientes de MCP

Para otros clientes MCP, consulte su documentación para saber cómo configurar servidores MCP.

Solución de problemas

Si encuentra problemas con el servidor:

Comprueba que tus credenciales de API sean correctas
Asegúrese de que el servidor esté configurado correctamente en su cliente MCP
Busque mensajes de error en los registros
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

Ejemplo de uso

Una vez que el servidor esté conectado a su cliente MCP, puede usarlo con lenguaje natural:

"Enumerar los mensajes disponibles en promptz.dev"
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"

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)

promptz.dev MCP Server

Integrations