@jjongal/mcp-server

쫑알(jjongal) 데스크톱 펫을 AI가 다루게 해주는 MCP 서버입니다. 내 AI(Claude Code · Cursor · Claude Desktop)에게 "오늘 일정 알려줘", "내일 체육대회 캘린더에 넣어줘", "이 할일 완료해줘"처럼 시키면 내 컴퓨터의 쫑알이 그대로 처리합니다.

데이터는 전부 내 컴퓨터 안에만 있습니다. 이 서버는 127.0.0.1(로컬)에서 토큰 인증으로만 동작하며, 내가 직접 연결한 내 AI에게만 접근을 엽니다.

설치

1. 쫑알 앱을 실행하고 설정 → AI 제어 허용을 켭니다(개인 키가 자동 발급됩니다).
2. 내 AI에 아래 한 줄을 더합니다. 키는 자동으로 전달되니 직접 입력할 필요가 없습니다.

Claude Code

claude mcp add jjongal -- npx -y @jjongal/mcp-server@latest

Cursor / Claude Desktop (mcp.json 또는 claude_desktop_config.json)

{
  "mcpServers": {
    "jjongal": {
      "command": "npx",
      "args": ["-y", "@jjongal/mcp-server@latest"]
    }
  }
}

WSL(윈도우의 리눅스)에서 쓸 때

윈도우에 쫑알을 설치하고 WSL 안의 클로드 코드에서 연결하는 경우, 대부분 추가 설정 없이 자동으로 윈도우의 쫑알을 찾아갑니다. 그래도 연결이 안 되면 아래를 확인해 주세요.

• 윈도우에서 쫑알이 켜져 있고 설정 → AI 제어 허용이 켜져 있어야 해요.
• WSL2 네트워킹을 mirrored 모드로 두면 가장 안정적이에요. 윈도우 사용자 폴더의 .wslconfig 파일에 아래를 넣고 wsl --shutdown 후 다시 켜 주세요.

  [wsl2]
  networkingMode=mirrored

• 그래도 안 되면 윈도우 호스트 IP를 직접 알려줄 수 있어요. 쫑알 MCP를 등록할 때 환경변수 JJONGAL_HOST에 윈도우 호스트의 IP를 넣어 주세요(예: WSL에서 cat /etc/resolv.conf의 nameserver 주소).

시작 프롬프트

AI에게 이렇게 붙여넣으면 바로 시작합니다.

내 쫑알(데스크톱 펫)에 연결돼 있어. jjongal_today로 오늘 일정 먼저 보여주고,
앞으로 내가 일정·할일 말하면 jjongal_add_todo로 쫑알 캘린더에 넣어줘.

도구

| 도구 | 하는 일 | |---|---| | jjongal_add_todo | 할일/캘린더 일정 추가 | | jjongal_quick_add | 자연어 한 줄로 추가 | | jjongal_complete_todo | 할일 완료 처리 | | jjongal_delete_todo | 할일 삭제 | | jjongal_set_importance | 중요도(1~3) 설정 | | jjongal_add_event_note | 학사일정에 메모 | | jjongal_today | 오늘 일정·시간표·급식 한눈에 | | jjongal_list_todos | 할일 목록(id 포함) | | jjongal_get_schedule | 시간표(이번/다음 주) | | jjongal_get_meals | 급식 식단 | | jjongal_get_school_events | 학사일정 | | jjongal_emote | 경수 감정 표현 | | jjongal_speak | 경수 말풍선(최대 140자) | | jjongal_list_emotes | 가능한 감정 목록 |

안전

• 로컬 전용(127.0.0.1), Bearer 토큰 인증, 설정에서 끄면 즉시 차단됩니다.
• 노출 범위는 일정·할일·학교 데이터(읽기)와 펫 연출뿐입니다. 파일·네트워크·앱 제어는 열지 않습니다.
• 내가 연결한 AI가 읽은 일정 내용은 그 AI 제공자에게 전달될 수 있습니다.

MIT License