promptz.dev MCP 服务器

直接从您的AI助手访问来自promptz.dev的提示。

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

功能

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

1. 工具 - 可执行函数，允许AI助手与promptz.dev API交互
2. 提示 - 直接以MCP提示模板的形式访问提示

工具和提示API

工具

该服务器通过MCP协议公开了以下工具：

list_prompts

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

输入模式：

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination token for fetching the next set of results"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter prompts by tags (e.g. ['CLI', 'JavaScript'])"
    }
  }
}

示例用法：

// List all prompts
list_prompts()

// List prompts with pagination
list_prompts({ "cursor": "next-page-token" })

// Filter prompts by tags
list_prompts({ "tags": ["JavaScript", "CLI"] })

响应格式：

{
  "prompts": [
    {
      "name": "React Component Generator",
      "description": "Generates React components based on specifications",
      "tags": ["React", "JavaScript", "Frontend"]
    }
    // More prompts...
  ],
  "nextCursor": "optional-pagination-token"
}

get_prompt

按名称检索特定提示。

输入模式：

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the prompt to retrieve"
    }
  },
  "required": ["name"]
}

示例用法：

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

响应格式：

{
  "name": "React Component Generator",
  "description": "Generates React components based on specifications",
  "instruction": "Create a React component that...",
  "tags": ["React", "JavaScript", "Frontend"]
}

提示API

该服务器还实现了MCP提示功能，允许AI助手直接以模板形式访问提示：

• 列表提示：以MCP提示模板格式返回可用提示
• 获取提示：以可由AI助手直接使用的MCP提示模板格式返回特定提示

安装

第一步：获取API凭据

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

第二步：安装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

1. 安装依赖并构建：

npm install
npm run build

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

第三步：配置您的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检查器进行调试：

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

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

开发

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

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

示例用法

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

• "从 promptz.dev 列出可用的提示"
• "搜索关于 JavaScript 的 CLI 提示"
• "向我展示名为 'React 组件文档' 的提示"
• "使用 React 组件文档提示来改进我的文档"

安全注意事项

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