promptz.dev MCP Server

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

此MCP服务器允许您通过promptz.dev API访问提示，无需复制粘贴，减少开发流程中的上下文切换和摩擦。

功能

promptz.dev MCP Server 提供了两个主要功能：

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

示例用法

一旦服务器连接到Amazon Q Developer，您可以使用自然语言来使用它，例如：

• “搜索关于JavaScript的CLI提示”
• “显示名为'React组件文档'的提示”
• “使用React组件文档提示改进我的文档”
• “查找CDK开发的项目规则”
• “将CDK项目结构项目规则添加到我的工作区”

安装

第一步：获取API凭证

1. 导航至 https://promptz.dev/mcp
2. 复制MCP设置，如API密钥、API URL或示例MCP配置片段。

第二步：安装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进行调试：

# 使用环境变量运行
PROMPTZ_API_URL="your-api-url" PROMPTZ_API_KEY="your-api-key" npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。

开发

对于希望贡献或修改服务器的人：

# 安装依赖
npm install

# 构建服务器
npm run build

# 开发时自动重建
npm run watch

# 运行测试
npm test

安全注意事项

• 此服务器仅提供对提示的读取访问权限，不实现任何写操作
• API凭证存储在您的MCP客户端配置文件中
• 所有与promptz.dev API的通信均通过HTTPS进行
• 服务器日志记录到您的主目录中的文件（~/.promptz/logs/mcp-server.log）