# 냥톨로지

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

원격 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

Related MCP server: Context Loom

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

예시 질문 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개)

냥톨로지

노드 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