popup-mcp

Name: popup-mcp
Author: richard-kim-79

本地服务

github.com/richard-kim-79生产力015 周前更新

代码仓库

关于 popup-mcp

popup-mcp 是一个 MCP 服务，可通过 Claude 等 AI 客户端创建、编辑和删除 Popup 网页。它支持按内容块编辑和使用模板，网页可通过链接分享，无需登录。

主要功能

01创建和删除网页
02替换或编辑网页内容块
03通过模板创建网页
04查看网页和模板列表
05上传图片并获取网页详情

适用场景

01创建活动邀请页面
02用模板制作个人链接页
03编辑现有页面的标题和按钮

MCP 相关

该服务提供九种工具，用于创建、查看、编辑和删除 Popup 网页、管理模板及请求图片上传 URL。客户端可通过 MCP API 密钥连接，例如 Claude Desktop。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "richard-kim-79-popup": {
      "command": "npx",
      "args": [
        "-y",
        "@blueslap/popup-mcp"
      ],
      "env": {
        "MCP_API_KEY": "<MCP_API_KEY>"
      }
    }
  }
}

启动命令npx -y @blueslap/popup-mcp

需要配置的环境变量

MCP_API_KEY密钥Popup API Key — https://leaf-bluewhale2025.vercel.app/admin 에서 발급 (lf_live_... 형식)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@blueslap/popup-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
blocks	array	是	内容区块数组

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

Popup MCP Server

30초 만에 웹페이지를 만들고 AI로 편집하세요. 로그인 불필요, 링크 하나로 공유.

Popup MCP Server를 Claude에 연결하면 대화만으로 웹페이지를 생성·편집·삭제할 수 있습니다.

설치 방법

Claude Desktop (권장)

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 추가:

{
  "mcpServers": {
    "popup": {
      "command": "npx",
      "args": ["-y", "@popup-ai/mcp-server"],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

API 키 발급: https://leaf-bluewhale2025.vercel.app/admin 관리자 대시보드에서 발급

사용 가능한 도구 (9개)

도구	설명	읽기 전용
`create_page`	블록 배열로 새 페이지 생성	❌
`get_page`	페이지 콘텐츠·메타데이터 조회	✅
`update_page_blocks`	페이지 전체 블록 교체	❌
`edit_page_blocks`	부분 편집 (insert/update/delete/move)	❌
`delete_page`	페이지 삭제 (소프트 딜리트)	❌ ⚠️
`list_my_pages`	내 페이지 목록 조회	✅
`list_templates`	사용 가능한 템플릿 목록	✅
`create_page_from_template`	템플릿으로 페이지 생성	❌
`upload_image`	이미지 업로드 URL 요청	❌

사용 예시

예시 1: 이벤트 초대 페이지 만들기

"다음 내용으로 이벤트 초대 페이지를 만들어줘:
- 제목: 2025 봄 세미나
- 날짜: 4월 20일 오후 2시
- 장소: 제주 ICC
- 참가 신청 버튼 → https://forms.example.com"

Claude가 create_page 도구를 호출해 즉시 공유 링크를 반환합니다.

예시 2: 링크인바이오 페이지를 템플릿으로 생성

"link-in-bio 템플릿으로 페이지를 만들고,
제목을 'Richard의 링크 모음'으로 바꿔줘"

Claude가 create_page_from_template으로 생성 후 edit_page_blocks으로 제목 수정.

예시 3: 기존 페이지 수정

"abc123 페이지의 첫 번째 제목을 '업데이트된 제목'으로 바꾸고,
맨 아래에 '자세히 보기' 버튼을 추가해줘"

Claude가 get_page로 현재 상태 확인 후 edit_page_blocks으로 정확히 수정.

블록 타입

타입	설명
`h1`	대제목
`h2`	소제목
`text`	본문 텍스트
`image`	이미지 (URL 또는 업로드)
`button`	링크 버튼
`divider`	구분선
`youtube`	유튜브 영상
`link`	링크 카드 (OG 미리보기)