PromStack MCP Server

PromStack의 공식 MCP(Model Context Protocol) 서버 구현체입니다.
**Official @modelcontextprotocol/sdk**를 사용하여 안정성과 호환성을 보장합니다.

이 서버를 통해 Claude Desktop, Cursor 등 MCP 호환 도구에서 PromStack의 프롬프트를 직접 불러오고 실행할 수 있습니다.

🚀 시작하기

1. 사전 요구사항

• Node.js 18.0.0 이상
• PromStack API Key (설정 > API Keys에서 발급)

2. 설치

npm install

3. CLI 실행

# 직접 실행
node bin/promstack-mcp.js --api-key YOUR_API_KEY

# 또는 환경 변수 사용
export PROMPTSTACK_API_KEY=YOUR_API_KEY
node bin/promstack-mcp.js

⚙️ Claude Desktop 설정

Claude Desktop 설정 파일 로드:

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

{
  "mcpServers": {
    "promstack": {
      "command": "node",
      "args": [
        "D:/workspace/Prompt-Manager/mcp-server/bin/promstack-mcp.js",
        "--api-key",
        "YOUR_PK_LIVE_KEY"
      ]
    }
  }
}

주의: args의 경로는 실제 mcp-server가 위치한 절대 경로로 수정해야 합니다.

🛠️ 제공 도구 (Tools)

| 도구명 | 설명 | | --- | --- | | list_prompts | 프롬프트 목록 검색 및 조회 | | get_prompt | 특정 프롬프트의 상세 내용(템플릿) 조회 | | select_prompt | 작업 설명에 맞는 최적의 프롬프트 추천 (Semantic Search) | | export_skill | 프롬프트를 AI 에이전트용 스킬로 내보내기 |

🏗️ 아키텍처

이 서버는 Proxy 역할을 수행합니다. User -> MCP Client (Claude) -> MCP Server (Local) -> HTTP (JSON-RPC) -> PromStack Backend

• SDK: @modelcontextprotocol/sdk
• Transport: StdioServerTransport
• Validation: zod