promptz.dev MCP 服务器

直接从你的 AI 助手访问 promptz.dev 上的 prompts。

这个 MCP 服务器允许你从 promptz.dev API 访问 prompts，无需复制粘贴，减少了上下文切换和开发工作流程中的摩擦。

功能

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

1. 工具 (Tools) - 可执行函数，允许 AI 助手与 promptz.dev API 交互
2. Prompts - 直接访问 prompts 作为 MCP prompt 模板

工具和 Prompts API

工具

服务器通过 MCP 协议暴露以下工具：

list_prompts

列出 promptz.dev 平台上可用的 prompts。

输入 Schema:

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "用于获取下一组结果的分页 token"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "按标签过滤 prompts (例如 ['CLI', 'JavaScript'])"
    }
  }
}

使用示例:

// 列出所有 prompts
list_prompts()

// 使用分页列出 prompts
list_prompts({ "cursor": "next-page-token" })

// 按标签过滤 prompts
list_prompts({ "tags": ["JavaScript", "CLI"] })

响应格式:

{
  "prompts": [
    {
      "name": "React Component Generator",
      "description": "根据规范生成 React 组件",
      "tags": ["React", "JavaScript", "Frontend"]
    }
    // 更多 prompts...
  ],
  "nextCursor": "optional-pagination-token"
}

get_prompt

按名称检索特定的 prompt。

输入 Schema:

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "要检索的 prompt 的名称"
    }
  },
  "required": ["name"]
}

使用示例:

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

响应格式:

{
  "name": "React Component Generator",
  "description": "根据规范生成 React 组件",
  "instruction": "创建一个 React 组件，该组件...",
  "tags": ["React", "JavaScript", "Frontend"]
}

Prompts API

服务器还实现了 MCP Prompts 功能，允许 AI 助手直接访问 prompts 作为模板：

• List Prompts: 以 MCP prompt 模板格式返回可用的 prompts
• Get Prompt: 返回特定的 prompt 作为 MCP prompt 模板，可直接被 AI 助手使用

安装

步骤 1: 获取 API 凭据

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

步骤 2: 安装 MCP 服务器

选项 1: 使用 npx (推荐)

使用服务器最简单的方法是使用 npx，它不需要安装：

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

步骤 3: 配置你的 MCP 客户端

Claude Desktop

将服务器配置添加到 Claude Desktop 配置文件中：

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

如果该文件不存在，请使用以下内容创建它：

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

其他 MCP 客户端

对于其他 MCP 客户端，请参阅其文档以了解如何配置 MCP 服务器。

故障排除

如果你遇到服务器问题：

1. 检查你的 API 凭据是否正确
2. 确保服务器在你的 MCP 客户端中配置正确
3. 在日志中查找错误消息
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

使用示例

一旦服务器连接到你的 MCP 客户端，你就可以使用自然语言来使用它：

• "列出 promptz.dev 上可用的 prompts"
• "搜索关于 JavaScript 的 CLI prompts"
• "显示名为 'React Component Documentation' 的 prompt"
• "使用 React Component Documentation prompt 来改进我的文档"

安全注意事项

• 此服务器仅提供对 prompts 的读取访问权限，不实现任何写入操作
• API 凭据存储在你的 MCP 客户端的配置文件中
• 与 promptz.dev API 的所有通信都通过 HTTPS 完成
• 服务器将日志记录到你主目录中的文件中 (~/.promptz/logs/mcp-server.log)