Daum Search MCP Server

Daum 검색 API를 통합한 MCP 서버 구현체로, 웹, 동영상, 이미지, 블로그, 책, 카페 검색 기능을 제공합니다.

설치 방법

NPM 패키지로 설치

# 전역 설치
npm install -g daum-search-mcp

# 프로젝트에 직접 설치
npm install daum-search-mcp

npx로 직접 실행

# 환경 변수 설정
export KAKAO_API_KEY="your_kakao_api_key"

# npx로 실행
npx daum-search-mcp

로컬 설치

# 저장소 클론
git clone https://github.com/ultra21c/mcp-servers.git
cd mcp-servers/src/daum-search

# 의존성 설치
npm install

사용 방법

1. Kakao Developers 설정

카카오 API 키 발급 절차:

1. 카카오 개발자 센터 가입

   • Kakao Developers에 접속
   • 우측 상단의 '로그인' 버튼 클릭
   • 카카오 계정으로 로그인 (계정이 없는 경우 회원가입)

2. 애플리케이션 등록

   • 상단 메뉴에서 '내 애플리케이션' 클릭
   • '애플리케이션 추가하기' 버튼 클릭
   • 앱 정보 입력:
     • 앱 아이콘 업로드 (선택사항)
     • 앱 이름 입력
     • 회사 이름 입력
   • '저장' 버튼 클릭

3. REST API 키 확인

   • 생성된 애플리케이션 선택
   • 좌측 메뉴에서 '요약 정보' 선택
   • 'REST API 키' 확인 및 복사

4. API 키 적용

   # 환경 변수로 설정
   export KAKAO_API_KEY="복사한_REST_API_키"

2. 실행 방법

로컬에서 실행:

# 환경 변수 설정
export KAKAO_API_KEY="your_kakao_api_key"

# 개발 모드로 실행
npm run watch

# 또는 빌드 후 실행
npm run build
npm start

Docker로 설치한 경우:

# 이미지 다운로드 및 실행
docker run -p 3100:3100 -e KAKAO_API_KEY="your_kakao_api_key" daum-search-mcp

Docker로 직접 빌드하여 실행:

# 저장소 클론 (이미 클론한 경우 건너뛰기)
git clone https://github.com/ultra21c/mcp-servers.git
cd mcp-servers/src/daum-search

# Docker 이미지 빌드
docker build -t daum-search-mcp .

# Docker 컨테이너 실행
docker run -p 3100:3100 -e KAKAO_API_KEY="your_kakao_api_key" daum-search-mcp

Docker Compose를 사용하는 경우, docker-compose.yml 파일을 다음과 같이 작성할 수 있습니다:

version: '3'
services:
  daum-search-mcp:
    build: .
    ports:
      - "3100:3100"
    environment:
      - KAKAO_API_KEY=your_kakao_api_key

그런 다음 다음 명령으로 실행합니다:

docker-compose up -d

3. Claude Desktop에서 사용하기

claude_desktop_config.json에 다음 내용을 추가하세요:

NPM 패키지 사용 시:

{
  "mcpServers": {
    "daum-search": {
      "command": "npx",
      "args": [
        "-y",
        "daum-search-mcp@latest"
      ],
      "env": {
        "KAKAO_API_KEY": "YOUR_KAKAO_REST_API_KEY_HERE"
      }
    }
  }
}

로컬에서 사용시

• build

npm run build

• config

{
  "mcpServers": {
    "daum-search": {
      "command": "node",
      "args": [
        "/your-full-path/mcp-servers/daum-search/dist/index.js"
      ],
      "env": {
        "KAKAO_API_KEY": "YOUR_KAKAO_REST_API_KEY_HERE"
      }
    }
  }
}

• Ref. how to build mcp-server with typescript sdk

제공되는 검색 기능

• 웹 검색: 웹 문서 검색
• 동영상 검색: 카카오TV, 유튜브 등의 동영상 검색
• 이미지 검색: 이미지 검색
• 블로그 검색: 다음 블로그 게시물 검색
• 책 검색: 도서 정보 검색
• 카페 검색: 다음 카페 게시물 검색

각 검색 기능의 자세한 파라미터와 사용법은 아래 도구 설명을 참조하세요.

도구

• daum_total_search

  • 통합 검색 실행 (웹, 블로그, 카페, 동영상, 이미지, 책 검색을 동시에 수행)
  • 입력:
    • query (string): 검색어
    • size (number, 선택): 각 검색 서비스별 결과 수 (1-10, 기본값: 3)

• daum_web_search

  • 웹 문서 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/recency)
    • page (number, 선택): 페이지 번호 (1-50)
    • size (number, 선택): 페이지당 결과 수 (1-50)

• daum_vclip_search

  • 동영상 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/recency)
    • page (number, 선택): 페이지 번호 (1-15)
    • size (number, 선택): 페이지당 결과 수 (1-30)

• daum_image_search

  • 이미지 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/recency)
    • page (number, 선택): 페이지 번호 (1-50)
    • size (number, 선택): 페이지당 결과 수 (1-80)

• daum_blog_search

  • 블로그 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/recency)
    • page (number, 선택): 페이지 번호 (1-50)
    • size (number, 선택): 페이지당 결과 수 (1-50)

• daum_book_search

  • 책 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/latest)
    • target (string, 선택): 검색 필드 (title/isbn/publisher/person)
    • page (number, 선택): 페이지 번호 (1-50)
    • size (number, 선택): 페이지당 결과 수 (1-50)

• daum_cafe_search

  • 카페 검색 실행
  • 입력:
    • query (string): 검색어
    • sort (string, 선택): 정렬 방식 (accuracy/recency)
    • page (number, 선택): 페이지 번호 (1-50)
    • size (number, 선택): 페이지당 결과 수 (1-50)

개발자를 위한 정보

로컬에서 개발하기

# 저장소 클론
git clone https://github.com/ultra21c/mcp-servers.git
cd mcp-servers/daum-search

# 의존성 설치
npm install

# 개발 모드로 실행
npm run watch

# 테스트 실행
export KAKAO_API_KEY="your_kakao_api_key"
npm test

# 린트 검사
npm run lint

테스트

테스트를 실행하기 전에 Kakao API 키가 필요합니다:

# 환경 변수 설정
export KAKAO_API_KEY="your_kakao_api_key"

# 테스트 실행
npm test

# 테스트 커버리지 확인
npm test -- --coverage

# 특정 테스트만 실행
npm test -- -t "daum_total_search"  # 통합검색 테스트
npm test -- -t "daum_web_search"    # 웹검색 테스트

수동 테스트

각 도구는 JSON-RPC 형식의 명령어를 통해 직접 테스트할 수 있습니다:

# 통합검색 테스트
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"daum_total_search","arguments":{"query":"이효리"}},"id":1}' | node dist/index.js

# 웹검색 테스트
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"daum_web_search","arguments":{"query":"이효리"}},"id":1}' | node dist/index.js

# 블로그검색 테스트 (정렬 및 결과 수 지정)
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"daum_blog_search","arguments":{"query":"이효리","sort":"recency","size":5}},"id":1}' | node dist/index.js

# 도구 목록 확인
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

테스트는 다음 기능들을 검증합니다:

• 통합 검색 기능
• 웹 검색 기능
• 동영상 검색 기능
• 이미지 검색 기능
• 블로그 검색 기능
• 책 검색 기능
• 카페 검색 기능

각 테스트는 실제 API 호출을 통해 응답이 올바른 형식으로 반환되는지 확인합니다.

빌드하기

npm run build

라이선스

이 MCP 서버는 MIT 라이선스로 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.