Kyobo Book MCP Server

🚀 교보문고 전자도서관을 위한 MCP (Model Context Protocol) 서버

AI 어시스턴트(Claude Desktop)가 교보문고 전자도서관의 책을 자동으로 읽고 관리할 수 있도록 도와주는 도구입니다.

✨ 주요 기능

• 🔐 자동 로그인: 교보문고 계정으로 자동 로그인
• 📚 책 목록 조회: 구매한 전자책 목록 확인
• 📖 책 읽기: 제목으로 책을 검색하여 읽기 모드 진입
• 📄 페이지 탐색: 다음/이전 페이지 이동, 특정 페이지로 이동
• 📸 스크린샷 캡처: 특정 페이지 범위의 스크린샷 캡처 (Base64)
• ℹ️ 페이지 정보: 현재 페이지, 총 페이지, 챕터 정보 확인
• 🤖 자동화 우회: Chrome DevTools Protocol을 사용한 자동화 감지 우회
• 🌐 브라우저 관리: 실제 Chrome 브라우저 자동 제어

🚀 빠른 시작

설치

npm install -g kybobook-mcp

Claude Desktop 설정

Claude Desktop의 설정 파일에 다음을 추가하세요:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kybobook": {
      "command": "kybobook-mcp"
    }
  }
}

또는

pnpm install

### 2. MCP 설정 (선택사항)

Claude Desktop이나 다른 MCP 클라이언트의 설정 파일에서 Chrome 경로를 지정할 수 있습니다:

**Claude Desktop 설정 예시 (`mcp.json`):**

```json
{
  "mcpServers": {
    "kybobook-mcp": {
      "command": "node",
      "args": ["./dist/mcp/server.js"],
      "env": {
        "CHROME_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
      }
    }
  }
}

지원되는 Chrome 경로 설정 방법:

1. MCP 설정의 env: 위의 mcp.json 예시처럼 CHROME_PATH 환경 변수 설정

3. 빌드

npm run build
# 또는
pnpm build

🔧 사용법

개발 모드

npm run dev
# 또는
pnpm dev

📋 MCP 도구 목록

| 도구명 | 설명 | 매개변수 | | ----------------------- | --------------------- | -------------------------------------------- | | login | 교보문고 로그인 | 없음 | | get_my_book_list | 구매한 책 목록 조회 | 없음 | | reading_book | 책 읽기 모드 진입 | booktitle (필수), page (선택, 기본값: 1) | | next_page | 다음 페이지로 이동 | count (선택, 기본값: 1) | | prev_page | 이전 페이지로 이동 | count (선택, 기본값: 1) | | move_page | 특정 페이지로 이동 | page (필수) | | get_pages_screenshot | 페이지 스크린샷 캡처 | startpage (필수), endpage (필수) | | get_current_page_info | 현재 페이지 정보 조회 | 없음 | | close_browser | 브라우저 종료 | 없음 |

💡 사용 예시

1. 로그인

{
  "name": "login",
  "arguments": {}
}

2. 책 목록 조회

{
  "name": "get_my_book_list",
  "arguments": {}
}

3. 책 읽기 (3페이지부터 시작)

{
  "name": "reading_book",
  "arguments": {
    "booktitle": "노인과 바다",
    "page": 3
  }
}

4. 페이지 이동

{
  "name": "next_page",
  "arguments": {
    "count": 2
  }
}

5. 스크린샷 캡처

{
  "name": "get_pages_screenshot",
  "arguments": {
    "startpage": 1,
    "endpage": 5
  }
}

🔒 보안 및 주의사항

1. 로그인 정보: 이 도구는 로그인 정보를 저장하지 않습니다
2. 브라우저 세션: 브라우저가 열린 상태로 유지되므로 사용 후 close_browser 호출 권장
3. 개인정보: 구매한 책 정보만 접근하며, 다른 개인정보에는 접근하지 않습니다

🐛 문제 해결

Chrome을 찾을 수 없는 경우

Chrome browser not found.

→ MCP 클라이언트 설정에서 CHROME_PATH 환경 변수를 설정하거나 Chrome을 기본 위치에 설치하세요.

Claude Desktop 설정 예시:

{
  "mcpServers": {
    "kybobook-mcp": {
      "command": "node",
      "args": ["./dist/mcp/server.js"],
      "env": {
        "CHROME_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
      }
    }
  }
}

로그인 실패

• 브라우저 창에서 수동으로 로그인을 완료해주세요
• 2단계 인증이 설정된 경우 수동 처리가 필요할 수 있습니다

책을 찾을 수 없는 경우

• 책 제목을 정확히 입력했는지 확인하세요
• page 매개변수를 조정하여 다른 페이지에서 검색해보세요

📄 라이선스

MIT License

🤝 기여하기

이슈 리포트나 풀 리퀘스트를 환영합니다!