使用说明

项目简介

promptz.dev MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它允许开发者在自己的 AI 助手或 LLM 应用中直接访问 promptz.dev 上的海量 Prompt 资源。通过这个 MCP 服务器，用户无需手动复制粘贴 Prompt，即可在各种支持 MCP 协议的客户端（如 Claude Desktop）中无缝使用 promptz.dev 提供的优质 Prompt，从而提升工作效率，减少上下文切换。

主要功能点

Prompt 资源访问: 通过 MCP 协议将 promptz.dev 上的 Prompt 资源以结构化的方式提供给客户端。
Prompt 列表: 允许客户端列出 promptz.dev 上可用的 Prompt 资源，支持分页浏览。
Prompt 搜索: 支持客户端根据关键词搜索 promptz.dev 上的 Prompt 资源。
Prompt 获取: 允许客户端根据名称或ID获取 promptz.dev 上指定的 Prompt 资源的完整内容，包括指令 (instruction) 和描述 (description)。
工具集成: 提供 'list_prompts' 和 'get_prompt' 工具，方便 LLM 客户端通过自然语言指令调用和使用。

安装步骤

安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node Package Manager)。
克隆仓库: 虽然本仓库不是开源仓库，但假设用户已经获取了代码，通常的安装步骤是从仓库根目录开始。
安装依赖: 在项目根目录下运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 promptz.dev MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置 MCP 客户端的服务器配置信息。以下是一个典型的 JSON 格式配置示例，你需要将其添加到 MCP 客户端的配置文件中。以 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.dev/mcp"],
      "env": {
        "PROMPTZ_API_URL": "YOUR_PROMPTZ_API_URL",  // promptz.dev GraphQL API 的 URL，请替换为实际值
        "PROMPTZ_API_KEY": "YOUR_PROMPTZ_API_KEY"   // 你的 promptz.dev API 密钥，请替换为实际值
      }
    }
  }
}

配置参数说明:

'"promptz.dev"': 服务器名称，在客户端中用于标识和引用此服务器。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'"args": ["-y", "@promptz.dev/mcp"]': 传递给 'npx' 的参数，'"-y"' 表示自动确认安装包，'"@promptz.dev/mcp"' 是要运行的 npm 包名称，即 promptz.dev MCP Server 的入口。
'"env"': 环境变量配置，用于向服务器传递必要的配置信息。
- '"PROMPTZ_API_URL"': 必须配置。promptz.dev GraphQL API 的 URL。你需要从 https://promptz.dev/mcp 获取。
- '"PROMPTZ_API_KEY"': 必须配置。你的 promptz.dev API 密钥，用于身份验证。你需要从 https://promptz.dev/mcp 获取。

重要提示: 请务必替换 '"PROMPTZ_API_URL"' 和 '"PROMPTZ_API_KEY"' 为你在 https://promptz.dev/mcp 获取的真实 API URL 和 API 密钥。

基本使用方法

配置完成后，在支持 MCP 协议的客户端中，你可以通过自然语言指令来使用 promptz.dev MCP Server 提供的功能。例如，在 Claude Desktop 中，你可以尝试以下指令：

列出 Prompt: "List available prompts from promptz.dev"
搜索 Prompt: "Search for prompts about JavaScript on promptz.dev"
获取指定 Prompt: "Show me the prompt called 'React Component Generator' from promptz.dev"

客户端会将这些自然语言指令转换为对 MCP 服务器的工具调用或 Prompt 请求，从而获取 promptz.dev 上的 Prompt 资源并返回给用户。

promptz.dev MCP Server