What is Promptz Mcp

promptz-mcp is an MCP Server implementation for promptz.dev, enabling direct access to prompts from the promptz.dev API for AI assistants.

Use cases

Use cases include listing available prompts, filtering prompts by tags, retrieving specific prompts, and utilizing prompts for various AI tasks.

How to use

To use promptz-mcp, obtain API credentials from promptz.dev, install the server using npx or locally, and configure your MCP client with the provided settings.

Key features

Key features include executable tools for interacting with the promptz.dev API and direct access to prompt templates as MCP prompts.

Where to use

promptz-mcp can be used in AI development environments, particularly where integration with promptz.dev’s prompt library is needed.

promptz.dev MCP Server

Access prompts from promptz.dev directly within Amazon Q Developer.

This MCP server allows to access prompts from the promptz.dev API without copy-pasting, reducing context switching and friction in your development workflow.

Features

The promptz.dev MCP Server provides two main capabilities:

1. Prompts - Executable functions to search and execute prompts.
2. Rules - Executable functions to search for project rules and by integrating with other tools adding/updating them in your workspace.

Example Usage

Once the server is connected to Amazon Q Developer, you can use it with natural language like:

• “Search for CLI prompts about JavaScript”
• “Show me the prompt called ‘React Component Documentation’”
• “Use the React Component Documentation prompt to improve my documentation”
• “Find project rules for CDK Development”
• “Add the CDK Project Structure project rule to my workspace”

Installation

Step 1: Get API Credentials

1. Navigate to https://promptz.dev/mcp
2. Copy the MCP settings like API Key, API URL or the sample MCP configuration snippet.

Step 2: Install the MCP Server

Open the Amazon Q Developer MCP client settings file located at ~/.aws/amazonq/mcp.json

Option 1: Using npx (Recommended)

The easiest way to use the server is with npx, which doesn’t require installation:

1. Add the following configuration to your Amazon Q Developer MCP client’s settings file:

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

Option 2: Local Installation

1. Clone the repository:

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

2. Install dependencies and build:

npm install
npm run build

3. Add the following configuration to your MCP client’s settings file:

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

Troubleshooting

If you encounter issues with the server:

1. Check that your API credentials are correct
2. Ensure the server is properly configured in your MCP client
3. Look for error messages in the logs located ad ~/.promptz/logs/mcp-server.log
4. Use the MCP Inspector for debugging:

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

The Inspector will provide a URL to access debugging tools in your browser.

Development

For those who want to contribute or modify the server:

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

Security Considerations

• This server only provides read access to prompts and does not implement any write operations
• API credentials are stored in your MCP client’s configuration file
• All communication with the promptz.dev API is done via HTTPS
• The server logs to a file in your home directory (~/.promptz/logs/mcp-server.log)