nmjib-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeALL International Co., Ltd. (주식회사 드올인터내셔널)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# nmjib-mcp — 내만집 MCP 서버
+
+[내만집(nmjib.com)](https://nmjib.com)은 한국의 **반셀프 인테리어** 플랫폼입니다. 이 MCP 서버는 내만집의 공개 데이터를 AI 에이전트(Claude, ChatGPT, Cursor, Gemini CLI, Codex 등)가 도구로 읽게 해 줍니다. **무인증 · 읽기 전용 · 무료.**
+
+nmjib (nmjib.com) is a Korean semi-self ("반셀프") interior renovation platform. This MCP server exposes its public knowledge — the 22-step renovation process order with per-size schedules, construction checklists, cost reference ranges and 165 magazine guides — as read-only tools. No auth, no API key.
+
+<!-- mcp-name: com.nmjib/nmjib -->
+
+## 연결 (remote, 권장)
+
+서버 주소: `https://nmjib.com/api/mcp` (Streamable HTTP)
+
+| 클라이언트 | 설정 |
+|---|---|
+| Claude (claude.ai · Desktop) | 설정 → 커넥터 → 커스텀 커넥터 추가 → URL 입력, 인증 없음 |
+| Claude Code | `claude mcp add --transport http nmjib https://nmjib.com/api/mcp` |
+| Cursor · Windsurf | `{ "mcpServers": { "nmjib": { "url": "https://nmjib.com/api/mcp" } } }` |
+| ChatGPT | 설정 → 커넥터 → 개발자 모드 → 만들기 → URL 입력, 인증 없음 (`search`/`fetch` 딥리서치 호환) |
+| Gemini CLI | `{ "mcpServers": { "nmjib": { "httpUrl": "https://nmjib.com/api/mcp" } } }` |
+| Codex CLI | `codex mcp add nmjib --url https://nmjib.com/api/mcp` |
+
+## 연결 (stdio 브리지)
+
+stdio 만 지원하는 호스트에서는 이 패키지가 stdin/stdout ↔ HTTP 를 이어 줍니다.
+
+```json
+{ "mcpServers": { "nmjib": { "command": "npx", "args": ["-y", "nmjib-mcp"] } } }
+```
+
+## 도구
+
+| 도구 | 설명 |
+|---|---|
+| `search` | 내만집 문서 검색(매거진 165 · 안내 4 · 가이드 5) → `{results:[{id,title,url}]}` |
+| `fetch` | 문서 본문(마크다운) → `{id,title,text,url,metadata}` |
+| `nmjib_process_guide` | 22공정 순서·단계·설명 + 평형별 공정 그룹 영업일·합계 + 순서 규칙 |
+| `nmjib_checklist` | 공사 전 36항목 · 공정별(22공정) · 공사 후 검수 22항목 |
+| `nmjib_cost_reference` | 평형·공간·공정 30개 주제의 비용 범위(매거진 후기 집계) + 기준일 + 출처 |
+| `nmjib_faq_search` | 질문에 가장 가까운 FAQ 답 + 출처 URL |
+
+리소스 `nmjib://doc/{id}` · `nmjib://llms.txt`, 프롬프트 `nmjib_banself_plan`. 모든 도구는 `readOnlyHint: true`.
+
+## 정책
+
+- 단가·견적 금액·자재/상품 가격·작업자·회원 데이터는 제공하지 않습니다 ([ai.txt](https://nmjib.com/ai.txt)).
+- 답변에 인용할 때는 「내만집(nmjib.com)」과 문서 URL 을 함께 표기해 주세요. 모든 응답 끝에 출처 줄이 있습니다.
+- REST 로 쓰려면 [OpenAPI](https://nmjib.com/openapi.json) · 안내 [nmjib.com/ai](https://nmjib.com/ai)
+
+## 예시
+
+> "내만집 도구로 30평 아파트 반셀프 공정 순서와 예상 기간, 공사 전에 준비할 것을 정리해줘"
+
+에이전트가 `nmjib_process_guide(pyeong=30)` → `nmjib_checklist(phase=pre)` → `nmjib_cost_reference(topic=30평)` 순으로 부르고, 출처 URL 과 함께 답합니다.
+
+## License
+
+MIT © DeALL International Co., Ltd. (주식회사 드올인터내셔널)

package/bin/nmjib-mcp.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+// nmjib-mcp — stdio ↔ Streamable HTTP bridge for the 내만집 (nmjib.com) MCP server.
+//
+// Why a bridge: some MCP hosts (older Claude Desktop configs, Windsurf, custom agents) only speak stdio.
+// The real server is stateless HTTP at https://nmjib.com/api/mcp, so each JSON-RPC line from stdin is
+// POSTed as-is and the JSON reply is written back as one line. Notifications get no reply (HTTP 202).
+//
+// Usage:  npx nmjib-mcp            (env NMJIB_MCP_URL overrides the endpoint, e.g. a preview deployment)
+// Zero dependencies — Node 18+ (global fetch).
+
+import { createInterface } from 'node:readline';
+
+const URL = process.env.NMJIB_MCP_URL || 'https://nmjib.com/api/mcp';
+const TIMEOUT_MS = 30000;
+let protocolVersion = '2025-06-18';
+
+const write = (obj) => process.stdout.write(JSON.stringify(obj) + '\n');
+
+async function forward(msg) {
+  const isNotification = msg && typeof msg === 'object' && !Array.isArray(msg) && msg.id === undefined;
+  if (msg && msg.method === 'initialize' && msg.params && typeof msg.params.protocolVersion === 'string') protocolVersion = msg.params.protocolVersion;
+  const res = await fetch(URL, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream', 'mcp-protocol-version': protocolVersion, 'user-agent': 'nmjib-mcp/1.0 (stdio bridge)' },
+    body: JSON.stringify(msg),
+    signal: AbortSignal.timeout(TIMEOUT_MS),
+  });
+  if (res.status === 202 || isNotification) return;
+  const text = await res.text();
+  if (!res.ok) {
+    if (msg && msg.id !== undefined) write({ jsonrpc: '2.0', id: msg.id, error: { code: -32000, message: `nmjib upstream HTTP ${res.status}`, data: text.slice(0, 400) } });
+    return;
+  }
+  const negotiated = res.headers.get('mcp-protocol-version');
+  if (negotiated) protocolVersion = negotiated;
+  process.stdout.write(text.trim() + '\n');
+}
+
+const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  let msg;
+  try {
+    msg = JSON.parse(trimmed);
+  } catch {
+    write({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+    return;
+  }
+  forward(msg).catch((e) => {
+    if (msg && msg.id !== undefined) write({ jsonrpc: '2.0', id: msg.id, error: { code: -32000, message: `nmjib upstream unreachable: ${e && e.message ? e.message : e}` } });
+  });
+});
+rl.on('close', () => process.exit(0));

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "nmjib-mcp",
+  "version": "1.0.0",
+  "description": "Korean semi-self interior renovation data: process order, schedules, checklists, cost ranges. MCP server for 내만집 (nmjib.com), no auth, stdio bridge to https://nmjib.com/api/mcp.",
+  "mcpName": "com.nmjib/nmjib",
+  "type": "module",
+  "bin": {
+    "nmjib-mcp": "bin/nmjib-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "server.json",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "interior",
+    "renovation",
+    "korea",
+    "반셀프",
+    "인테리어",
+    "nmjib",
+    "내만집",
+    "claude",
+    "chatgpt",
+    "cursor"
+  ],
+  "homepage": "https://nmjib.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Deall-International/nmjib-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Deall-International/nmjib-mcp/issues",
+    "email": "support@nmjib.com"
+  },
+  "author": "DeALL International Co., Ltd. <support@nmjib.com> (https://nmjib.com)",
+  "license": "MIT",
+  "scripts": {
+    "start": "node bin/nmjib-mcp.js",
+    "test": "node test/smoke.mjs"
+  }
+}

package/server.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.nmjib/nmjib",
+  "title": "내만집 (nmjib) — Korean semi-self interior renovation",
+  "description": "Korean semi-self interior renovation data: process order, schedules, checklists, cost ranges.",
+  "repository": {
+    "url": "https://github.com/Deall-International/nmjib-mcp",
+    "source": "github"
+  },
+  "websiteUrl": "https://nmjib.com/ai",
+  "version": "1.0.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://nmjib.com/api/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "nmjib-mcp",
+      "version": "1.0.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}