apick-mcp 2.2.0 → 2.4.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 변경 기록
 
+## 2.4.1 - 2026-09-05
+
+- 이미지 편집 Tool에서 마스크 입력을 제거하고 원본 이미지와 프롬프트만 받도록 동기화했습니다.
+
+## 2.4.0 - 2026-09-05
+
+- 이미지 생성·편집·대량 작업 Tool 6종을 추가해 전체 89개, AI 그룹 10개로 갱신했습니다.
+- 성공 이미지당 25포인트, 최대 50장, 멱등 키와 24시간 결과 보관 계약을 반영했습니다.
+
+## 2.3.0 - 2026-09-03
+
+- `identity_document_residence_card`의 개인정보 마스킹 대상을 외국인등록증·영주증·외국국적동포 국내거소신고증으로 확대했습니다.
+- 요청·응답 형식과 `document_type: residence_card` 계약은 유지합니다.
+- 외국인등록증 진위확인 Tool의 지원 범위는 변경하지 않았습니다.
+
 ## 2.2.0 - 2026-09-01
 
 - 운영 MCP에 비동기 TTS 접수·상태·취소·MP3·ASS 자막 Tool 5종을 동기화했습니다.

package/README.md

@@ -2,7 +2,7 @@
 
 <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
 
-# APICK MCP — 83 Korean Data & AI Tools
+# APICK MCP — 89 Korean Data, AI & Image Tools
 
 **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
 
@@ -22,9 +22,9 @@
 
 ## What is this? / 이게 뭔가요?
 
-**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **83 tools** that let Claude, ChatGPT, Cursor, Cline and any other MCP client look up Korean business registries, verify ID documents, track parcels, run OCR, create asynchronous TTS jobs, convert files, query DNS/WHOIS, search the web, and call LLMs — using one API key, billed per call.
+**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **89 tools** for Korean business data, identity verification, OCR, parcel tracking, image generation and editing, file conversion, web intelligence, and LLM calls.
 
-**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 83개**를 열어, Claude·ChatGPT·Cursor·Cline 등 MCP 클라이언트가 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 비동기 TTS, 파일 변환, DNS/WHOIS 조회, 웹 검색, LLM 호출을 **인증키 하나로** 직접 수행하게 합니다. 호출당 과금입니다.
+**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 89개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지 생성·편집, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
 
 **The server is hosted by APICK. Nothing to install, build, or keep running.**
 **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
@@ -42,8 +42,8 @@ https://apick.app/mcp/all
 Sign up at **[apick.app](https://apick.app)** and copy your license key from the dashboard. New accounts get **1,000 free points**.
 **[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.
 
-> `tools/list` works **without** a key — a client can connect and discover all 83 tools before you sign up. Only `tools/call` validates the key and allowed IP.
-> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 83개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
+> `tools/list` works **without** a key — a client can connect and discover all 89 tools before you sign up. Only `tools/call` validates the key and allowed IP.
+> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 89개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
 
 Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as `/32`. Changes apply immediately with no separate synchronization.
 마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
@@ -149,20 +149,20 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 | Server 서버 | Endpoint | Tools | Coverage 범위 |
 | --- | --- | --- | --- |
-| **All 통합** | `https://apick.app/mcp/all` | **83** | 아래 전부 |
+| **All 통합** | `https://apick.app/mcp/all` | **89** | 아래 전부 |
 | [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
 | [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
 | [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
 | [Web 웹·검색](TOOLS.md#web) | `https://apick.app/mcp/web` | 13 | 도메인·IP·WHOIS, 웹페이지 수집, 구글 검색, 유튜브 |
 | [Vision 이미지·영상](TOOLS.md#vision) | `https://apick.app/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
 | [OCR 문자인식](TOOLS.md#ocr) | `https://apick.app/mcp/ocr` | 6 | 이미지 텍스트 추출, 신분증 항목 추출 |
-| [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 4 | LLM 챗, 텍스트 요약·교정 |
+| [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 10 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업 |
 | [Finance 금융](TOOLS.md#finance) | `https://apick.app/mcp/finance` | 3 | 계좌 예금주 조회, 1원 인증 |
 
 ### Every tool / 전체 Tool
 
-**[→ TOOLS.md](TOOLS.md)** — all 83 tools with parameters, types, and copy-paste JSON-RPC examples.
-**[→ TOOLS.md](TOOLS.md)** — 83개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
+**[→ TOOLS.md](TOOLS.md)** — all 89 tools with parameters, types, and copy-paste JSON-RPC examples.
+**[→ TOOLS.md](TOOLS.md)** — 89개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
 
 <details>
 <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
@@ -181,7 +181,7 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 **Vision** `nsfw_detection` `image_similarity` `video_to_mp3` `extract_video_thumbnail` `word_cloud` `face_detection`
 
-**AI** `llm_models` `llm_chat` `text_summary` `text_polish`
+**AI** `llm_models` `llm_chat` `text_summary` `text_polish` `image_generate` `image_edit` `image_batch_create` `image_batch_status` `image_batch_cancel` `image_batch_result`
 
 </details>
 
@@ -209,6 +209,9 @@ Pull registry status, representative, industry code and address for each busines
 Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본.
 정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.
 
+`identity_document_residence_card`는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다.
+`identity_document_residence_card` masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.
+
 ### 3. Logistics & CS automation — 배송 문의 자동응답
 
 > "운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘"
@@ -265,7 +268,7 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
 | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
 | **Discovery** | `tools/list` returns every tool with JSON Schema, description and live price — no key needed | `tools/list`가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
-| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. Only 7 of 83 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 83개 중 부작용은 7개뿐 |
+| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 11 of 89 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 89개 중 상태 변경 Tool은 11개 |
 | **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
 | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
 | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
@@ -273,8 +276,8 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 
 ### Tools with side effects / 부작용이 있는 Tool
 
-76 of 83 tools are read-only. These 7 change state, charge points, cancel work, or consume a one-time result and carry `readOnlyHint: false` so your client can require approval:
-83개 중 76개는 조회입니다. 아래 7개는 과금·취소·1회 결과 소모 등 상태를 바꾸므로 `readOnlyHint: false`가 붙어 클라이언트가 승인을 요구할 수 있습니다.
+78 of 89 tools are read-only. The other 11 change state, charge points, cancel work, or consume a result and carry `readOnlyHint: false` so your client can require approval:
+89개 중 78개는 조회입니다. 나머지 11개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
 
 | Tool | What it does / 하는 일 |
 | --- | --- |
@@ -355,7 +358,7 @@ Korean business registry API · 사업자등록번호 조회 API · business reg
 
 ## Hashtags
 
-`#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#ChatGPT` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#음성인식` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
+`#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#음성인식` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
 
 ---
 

package/TOOLS.md

@@ -1,7 +1,7 @@
 # APICK MCP — Full Tool Catalog / 전체 Tool 목록
 
-**83 tools** across **8 domain servers**, plus the combined `all` server.
-**Tool 83개**, 분야별 서버 8개와 통합 서버 `all`.
+**89 tools** across **8 domain servers**, plus the combined `all` server.
+**Tool 89개**, 분야별 서버 8개와 통합 서버 `all`.
 
 Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
 
@@ -19,10 +19,10 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 | [Web & Search · 웹 · 검색](#web) | `/mcp/web` | 13 | 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브. |
 | [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
 | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
-| [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 4 | LLM 챗(다중 모델), 텍스트 요약·교정. |
-| **All 통합** | `/mcp/all` | **83** | 아래 전부 |
+| [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 10 | LLM 챗, 텍스트 도구, 이미지 생성·편집·대량 작업. |
+| **All 통합** | `/mcp/all` | **89** | 아래 전부 |
 
-<details><summary><b>All 83 tool names / 전체 Tool 이름</b></summary>
+<details><summary><b>All 89 tool names / 전체 Tool 이름</b></summary>
 
 `biz_detail` · `venture_biz_info` · `land_rt_price` · `req_pccc` · `get_pccc` · `check_pccc` · `get_car_flooding` · `get_car_scrap` · `parcel_tracking` · `parcel_tracking_auto` · `check_email_valid` · `check_phone_valid` · `check_spam_number` · `holiday_info` · `search_juso` · `info`
 
@@ -38,7 +38,7 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 
 `nsfw_detection` · `image_similarity` · `video_to_mp3` · `extract_video_thumbnail` · `word_cloud` · `face_detection`
 
-`llm_models` · `llm_chat` · `text_summary` · `text_polish`
+`llm_models` · `llm_chat` · `text_summary` · `text_polish` · `image_generate` · `image_edit` · `image_batch_create` · `image_batch_status` · `image_batch_cancel` · `image_batch_result`
 
 </details>
 
@@ -657,9 +657,9 @@ Mask resident registration numbers found in an image and return the masked image
 
 ### `identity_document_residence_card` — 외국인등록증 개인정보 마스킹
 
-Extract key fields from a Korean alien registration card (residence card) image and mask the last 6 digits of the registration number.
+Extract key fields from a Korean residence card, permanent resident card, or overseas Korean resident card image and mask the last 6 digits of the registration or domestic residence report number.
 
-외국인등록증 이미지에서 지정 정보를 추출하고 등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
+외국인등록증·영주증·외국국적동포 국내거소신고증 이미지에서 지정 정보를 추출하고 등록번호 또는 거소신고번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. 한 번에 신분증 한 장이 포함된 PNG 또는 JPEG 이미지만 전달해야 하며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 진위확인 Tool의 범위에는 포함되지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
 
 > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
 
@@ -1723,7 +1723,7 @@ Detect faces in an image and return their coordinates.
 
 ## AI & LLM · AI · LLM
 
-`https://apick.app/mcp/ai` — 4 tools
+`https://apick.app/mcp/ai` — 10 tools
 
 LLM chat across multiple models, text summarization, and polishing.
 
@@ -1735,6 +1735,14 @@ LLM 챗(다중 모델), 텍스트 요약·교정.
 | [`llm_chat`](#llm-chat) | LLM 채팅 | `model` |
 | [`text_summary`](#text-summary) | 텍스트 요약 AI | `text` |
 | [`text_polish`](#text-polish) | 텍스트 다듬기 AI | `text` |
+| `image_generate` | 이미지 한 장 생성 | `prompt`, `size?`, `output_format?`, `background?`, `output_compression?`, `idempotency_key?` |
+| `image_edit` | 이미지 한 장 편집 | `image_url`, `prompt` 및 출력 옵션 |
+| `image_batch_create` | 이미지 대량 작업 생성 | `mode`, `prompt`, `count`, 편집 파일 및 출력 옵션 |
+| `image_batch_status` | 대량 작업 상태 조회 | `job_id` |
+| `image_batch_cancel` | 대량 작업 취소 | `job_id` |
+| `image_batch_result` | 대량 작업 개별 결과 | `job_id`, `index` |
+
+이미지 생성·편집은 성공 결과 한 장당 25포인트입니다. 편집은 원본 이미지 한 장과 프롬프트만 받으며 마스크 파일은 지원하지 않습니다. 동기 Tool은 응답 크기를 위해 한 장만 반환하며, 대량 작업은 최대 50장 접수 후 `image_batch_result`로 한 장씩 가져옵니다. PNG·JPEG·WebP, 다양한 비율, PNG/WebP 투명 배경 미리보기를 지원합니다. 프롬프트는 최대 6,000자이고 완료 결과는 24시간 동안 반복 조회할 수 있습니다.
 
 <a id="llm-models"></a>
 
@@ -1769,8 +1777,8 @@ Send a chat request to a selected LLM model and receive the assistant reply.
 
 | Parameter | Type | Required | Description 설명 |
 | --- | --- | --- | --- |
-| `model` | `string` | **필수 / required** | 모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b) |
-| `messages` | `array` | 선택 / optional | OpenAI 형식 [{role, content}] 배열. role 은 'system'\|'user'\|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송 |
+| `model` | `string` | **필수 / required** | 모델 id (`llm_models` Tool로 조회) |
+| `messages` | `array` | 선택 / optional | 채팅 메시지 [{role, content}] 배열. role 은 'system'\|'user'\|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송 |
 | `content` | `string` | 선택 / optional | 단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수 |
 | `system` | `string` | 선택 / optional | system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다 |
 | `compact` | `object` | 선택 / optional | 히스토리 압축 옵션 { strategy: 'none'(기본) \| 'sliding_window', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. 긴 대화의 input 토큰 누적 방지 |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apick-mcp",
-  "version": "2.2.0",
-  "description": "APICK MCP — 83 Korean data & AI tools for AI agents. 사업자조회·신분증 진위확인·OCR·택배 배송조회·비동기 TTS·파일변환·WHOIS·구글검색·LLM. Korean business registry, ID verification, OCR, parcel tracking, asynchronous TTS, file conversion, web intelligence and LLM over MCP.",
+  "version": "2.4.1",
+  "description": "APICK MCP — 89 Korean data, AI, and image tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·파일변환·검색·LLM.",
   "type": "module",
   "license": "MIT",
   "author": "APICK",
@@ -42,7 +42,6 @@
     "claude",
     "claude-code",
     "claude-desktop",
-    "chatgpt",
     "cursor",
     "cline",
     "windsurf",
@@ -83,6 +82,8 @@
     "face-detection",
     "face-blur",
     "nsfw-detection",
-    "image-similarity"
+    "image-similarity",
+    "image-generation",
+    "image-editing"
   ]
 }