promptz.dev MCP 서버

AI 도우미에서 promptz.dev의 프롬프트에 직접 액세스하세요.

이 MCP 서버를 사용하면 복사-붙여넣기 없이 promptz.dev API에서 프롬프트에 액세스할 수 있으므로 개발 워크플로에서 컨텍스트 전환과 마찰이 줄어듭니다.

특징

promptz.dev MCP 서버는 두 가지 주요 기능을 제공합니다.

도구 - AI 어시스턴트가 promptz.dev API와 상호 작용할 수 있도록 하는 실행 가능한 기능
프롬프트 - MCP 프롬프트 템플릿으로 프롬프트에 직접 액세스

도구 및 프롬프트 API

도구

서버는 MCP 프로토콜을 통해 다음 도구를 제공합니다.

`list_prompts`

promptz.dev 플랫폼에서 사용 가능한 프롬프트를 나열합니다.

입력 스키마:

지엑스피1

사용 예:

// 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

이 서버는 또한 AI 어시스턴트가 프롬프트에 템플릿으로 직접 액세스할 수 있도록 하는 MCP 프롬프트 기능을 구현합니다.

프롬프트 목록 : MCP 프롬프트 템플릿 형식으로 사용 가능한 프롬프트를 반환합니다.
프롬프트 가져오기 : AI 어시스턴트가 직접 사용할 수 있는 MCP 프롬프트 템플릿으로 특정 프롬프트를 반환합니다.

설치

1단계: API 자격 증명 가져오기

https://promptz.dev/mcp 로 이동합니다.
API 키, API URL 또는 샘플 MCP 구성 스니펫과 같은 MCP 설정을 복사합니다.

2단계: MCP 서버 설치

옵션 1: npx 사용(권장)

서버를 사용하는 가장 쉬운 방법은 설치가 필요하지 않은 npx를 사용하는 것입니다.

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: 로컬 설치

저장소를 복제합니다.

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

종속성을 설치하고 빌드합니다.

npm install
npm run build

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 구성 파일에 서버 구성을 추가합니다.

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %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 서버를 구성하는 방법에 대한 설명서를 참조하세요.

문제 해결

서버에 문제가 발생하는 경우:

API 자격 증명이 올바른지 확인하세요
MCP 클라이언트에서 서버가 올바르게 구성되었는지 확인하세요.
로그에서 오류 메시지를 찾아보세요
디버깅을 위해 MCP Inspector를 사용하세요.

# 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 Component Documentation 프롬프트를 사용하여 내 문서를 개선하세요"

보안 고려 사항

이 서버는 프롬프트에 대한 읽기 액세스만 제공하며 쓰기 작업은 구현하지 않습니다.
API 자격 증명은 MCP 클라이언트의 구성 파일에 저장됩니다.
promptz.dev API와의 모든 통신은 HTTPS를 통해 이루어집니다.
서버는 홈 디렉토리의 파일에 기록합니다(~/.promptz/logs/mcp-server.log)

promptz.dev MCP Server

Integrations