promptz.dev MCP Server

promptz.dev MCP 服务

在 Amazon Q Developer 中直接访问 promptz.dev 的提示词。

此 MCP 服务可让你通过 promptz.dev API 访问提示词，无需复制粘贴，从而减少开发工作流中的上下文切换和阻碍。

功能

promptz.dev MCP 服务提供两项主要功能：

1. 提示词 - 用于搜索和执行提示词的可执行函数。
2. 规则 - 用于搜索项目规则，并与其他工具集成，以便在工作区中添加或更新规则的可执行函数。

使用示例

将服务连接到 Amazon Q Developer 后，你可以用自然语言这样使用它：

• “搜索关于 JavaScript 的 CLI 提示词”
• “显示名为 ‘React Component Documentation’ 的提示词”
• “使用 React Component Documentation 提示词改进我的文档”
• “查找 CDK Development 的项目规则”
• “将 CDK Project Structure 项目规则添加到我的工作区”

安装

第 1 步：获取 API 凭据

1. 前往 https://promptz.dev/mcp
2. 复制 MCP 设置，例如 API Key、API URL 或示例 MCP 配置片段。

第 2 步：安装 MCP 服务

打开位于 ~/.aws/amazonq/mcp.json 的 Amazon Q Developer MCP 客户端设置文件

选项 1：使用 npx（推荐）

使用此服务最简单的方式是通过 npx，无需安装：

1. 将以下配置添加到 Amazon Q Developer 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": []
    }
  }
}

选项 2：本地安装

1. 克隆仓库：

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

2. 安装依赖并构建：

npm install
npm run build

3. 将以下配置添加到 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": []
    }
  }
}

故障排除

如果服务遇到问题：

1. 检查 API 凭据是否正确
2. 确保已在 MCP 客户端中正确配置服务
3. 查看位于 ~/.promptz/logs/mcp-server.log 的日志中的错误消息
4. 使用 MCP Inspector 进行调试：

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

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

开发

如果你想为服务做出贡献或对其进行修改：

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

安全注意事项

• 此服务仅提供提示词的读取权限，不会执行任何写入操作
• API 凭据存储在 MCP 客户端的配置文件中
• 与 promptz.dev API 的所有通信均通过 HTTPS 进行
• 服务会将日志写入主目录中的文件（~/.promptz/logs/mcp-server.log）