냥톨로지

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

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

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

---

MCP 설치 (요약)

전체 단계·OS별 설정·문제 해결: docs/user-guide/INSTALL.md

1. 받기

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

2. 설치 · 검증

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

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

3. Cursor 연결

프로젝트 또는 전역 .cursor/mcp.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. 테스트 질문

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

---

일반 사용자 안내

냥톨로지란?

한 줄 요약: 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

검증 · 배포

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