# 냥톨로지

고양이 행동 신호를 근거와 함께 풀어주는 **read-only MCP 관찰 도우미**입니다. `고집사`는 사용자에게 친근하게 안내하는 보조 캐릭터/응답 콘셉트로 사용합니다.

| | |
| --- | --- |
| **GitHub** | https://github.com/ousia-web3/cat-signal-explorer-mcp |
| **MCP 설치 가이드** | [`docs/user-guide/INSTALL.md`](docs/user-guide/INSTALL.md) |
| **빠른 시작** | [`docs/user-guide/GETTING-STARTED.md`](docs/user-guide/GETTING-STARTED.md) |

원격 MCP URL·ChatGPT 연결 주소는 **공개 README에 포함하지 않습니다.** 로컬 설치는 위 **INSTALL.md**를 따르세요.

---

# MCP 설치 (요약)

전체 단계·OS별 설정·문제 해결: **[`docs/user-guide/INSTALL.md`](docs/user-guide/INSTALL.md)**

## 1. 받기

```powershell
git clone https://github.com/ousia-web3/cat-signal-explorer-mcp.git
cd cat-signal-explorer-mcp
```

## 2. 설치 · 검증

```powershell
python -m pip install -r requirements.txt
python smoke_test.py
```

`tool_count: 7`, `_is_error: false` 이면 성공입니다.

## 3. Cursor 연결

프로젝트 또는 전역 `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "냥톨로지": {
      "command": "python",
      "cwd": "C:/path/to/cat-signal-explorer-mcp",
      "args": ["server.py"]
    }
  }
}
```

`cwd`를 **clone한 폴더 절대 경로**로 바꾼 뒤 Cursor를 재시작합니다.

macOS/Linux, Claude Desktop 설정, 연결 확인 방법 → **INSTALL.md**

## 4. 테스트 질문

```text
갑자기 뛰어요. 냥톨로지로 시나리오·확인할 것·근거 영상까지 정리해줘.
```

---

# 일반 사용자 안내

## 냥톨로지란?

**한 줄 요약:** AI에 연결하면 “갑자기 뛰어요”, “하악질” 같은 질문에 냥톨로지 지식과 YouTube 공개 메타 근거를 바탕으로 답을 돕습니다.

- 공개 타이틀: `냥톨로지`
- 서브타이틀: `고양이 행동 신호를 근거와 함께 풀어주는 관찰 도우미`
- 보조 캐릭터/응답 콘셉트: `고집사`
- 내부 ID: `cat-signal-explorer`

| 할 수 있는 것 | 하지 않는 것 |
| --- | --- |
| 행동 신호·초보자 시나리오 탐색 | 진단·처방·치료 판단 |
| 돌봄 맥락·확인 체크리스트 안내 | 수의사 상담 대체 |
| YouTube 공개 메타 근거 연결 | 임의 의료 조언 |

## 예시 질문 10개

| # | 질문 |
| --- | --- |
| 1 | 갑자기 뛰어요 |
| 2 | 하악질이 나와요 |
| 3 | 밤에 우다다만 해요 |
| 4 | 물거나 깨물어요 |
| 5 | 울음소리 / 야옹이 늘었어요 |
| 6 | 그루밍·빗질이 고민돼요 |
| 7 | 화장실 / 배변·배뇨 변화가 걱정돼요 |
| 8 | 다묘인데 놀이인지 싸움인지 모르겠어요 |
| 9 | 골골송·꾹꾹이가 줄었어요 |
| 10 | 밥을 잘 안 먹어요 |

---

# 개발자 · 운영자 가이드

## 서비스 정의

- 공개 타이틀: `냥톨로지` · 보조 캐릭터: `고집사` · 내부 ID: `cat-signal-explorer`
- transport (로컬): **stdio** — `python server.py`
- transport (원격): **streamable-http** — `uvicorn http_app:app --host 0.0.0.0 --port ${PORT:-8080}`
- 상세: `service-definition.md` · PlayMCP in KC: `DEPLOY-PLAYMCP-KC.md` · Vercel: `DEPLOY-VERCEL.md` (URL 비공개)

## MCP 도구 (7개)

| tool | 용도 |
| --- | --- |
| `catbook_ontology_stats` | 그래프 요약 |
| `catbook_search_nodes` | 노드 검색 |
| `catbook_get_node_neighborhood` | 주변 맥락·근거 |
| `catbook_list_edges` | 엣지 조회 |
| `catbook_get_evidence` | YouTube 근거 |
| `catbook_run_sparql_preset` | SPARQL preset 8개 |
| `catbook_read_artifact` | artifact 읽기 |

## 냥톨로지

노드 956 · 엣지 4099 · 콘텐츠 1304 · 상세 `ontology-analysis.md`

## Safety

read-only · 비진단 safety note · `SECURITY.md`

## 검증 · 배포

```powershell
python smoke_test.py
python http_smoke_test.py
python package_upload.py
```

- GitHub: `UPLOAD.md`, `github-deployment-runbook.md`
- PlayMCP in KC: `Dockerfile`, `.dockerignore`, `DEPLOY-PLAYMCP-KC.md`
- 시각화: `visualization.md`
- 아이콘: `public/gojipsa-icon-256.png`, `public/README.md`