개요

Kibela MCP 서버는 현재 STDIO를 사용하는 로컬 서버로만 사용할 수 있으며 Claude Desktop이나 VSCode와 같은 모든 MCP 클라이언트와 함께 사용할 수 있습니다.

공개적으로 사용 가능하고 MCP에 적합한 GraphQL API만 도구로 구현됩니다.

사용 사례

• 키벨라에 대한 정보를 문의하세요
• Kibela에서 폴더와 문서 정리
• Kibela로 글쓰기를 돕는 AI 활용

요구 사항

1. Docker가 설치되었습니다
2. Docker가 실행 중이어야 합니다
3. Kibela 액세스 토큰이 발급됩니다.
4. MCP 클라이언트를 구현하는 애플리케이션을 설치해야 합니다.

설치

예: Claude Desktop

다음 구성을 claude_desktop_config.json 파일에 작성하세요. Kibela 원본과 액세스 토큰을 환경 변수로 설정하세요.

지엑스피1

도커 없음

그런 다음 스크립트를 실행 명령으로 설정합니다. 이때 스크립트 경로는 절대 경로여야 합니다.

사용 가능한 도구

참고 작업

• search_kibela_note - 노트 검색
  • query : 검색 키워드 (필수)
  • resources : 리소스 유형 필터(선택 사항)
  • coediting : 공동 편집 플래그(선택 사항)
  • updated : 날짜 범위 업데이트(선택 사항)
  • groupIds : 그룹 ID 필터(선택 사항)
  • folderIds : 폴더 ID 필터(선택 사항)
  • likerIds : Liker 사용자 ID 필터(선택 사항)
  • isArchived : 보관 플래그(선택 사항)
  • sortBy : 정렬 순서 (선택 사항)
• get_kibela_note_by_relay_id - Relay ID로 메모 가져오기
  • id Relay ID (필수)
• get_kibela_note_from_path_or_url - 경로 또는 URL에서 메모 가져오기
  • path : 메모의 경로 또는 URL(필수)
• get_kibela_notes - 폴더의 메모 가져오기
  • folderId : 폴더 ID (필수)
  • first : 앞의 레코드 수 (선택 사항)
  • last : 뒤부터의 레코드 수 (선택 사항)
• create_kibela_note - 새 노트 만들기
  • title : 메모 제목 (필수)
  • content : 메모 내용 (필수)
  • draft : 초안 플래그(선택 사항)
  • groupIds : 소속될 그룹 ID 목록(필수)
  • folders : 폴더 정보(선택 사항)
    • groupId : 그룹 ID
    • folderName : 폴더 이름
• update_kibela_note_content - 노트 내용 업데이트
  • id : 노트 ID (필수)
  • newContent : 새로운 콘텐츠(필수)
  • baseContent : 원본 콘텐츠(필수)

폴더 작업

• search_kibela_folder - 폴더 검색
  • query : 검색 키워드 (필수)
• get_kibela_folder_by_relay_id - Relay ID로 폴더 가져오기
  • id : 폴더의 릴레이 ID (필수)
  • first : 앞의 레코드 수 (선택 사항)
• get_kibela_folder_from_path_or_url - 경로 또는 URL에서 폴더 가져오기
  • path : 폴더의 경로 또는 URL(필수)
  • first : 앞의 레코드 수 (선택 사항)
• get_kibela_folders - 폴더 목록 가져오기
  • first : 앞의 레코드 수 (선택 사항)
  • last : 뒤부터의 레코드 수 (선택 사항)
• create_kibela_folder - 새 폴더 만들기
  • groupId : 그룹 ID (필수)
  • fullName : 폴더의 전체 경로 이름(필수)
• move_kibela_note_to_another_folder - 메모를 다른 폴더로 이동합니다.
  • id : 노트 ID (필수)
  • fromFolder : 소스 폴더 정보(필수)
    • groupId : 그룹 ID
    • folderName : 폴더 이름
  • toFolder : 대상 폴더 정보(필수)
    • groupId : 그룹 ID
    • folderName : 폴더 이름
• attach_kibela_note_to_folder - 메모를 폴더와 연결
  • id : 노트 ID (필수)
  • folder : 폴더 정보 (필수)
    • groupId : 그룹 ID
    • folderName : 폴더 이름

댓글 작업

• create_kibela_comment - 메모에 댓글을 작성합니다
  • content : 댓글 내용 (필수)
  • noteId : 대상 노트 ID(필수)
• create_kibela_comment_reply - 댓글에 대한 답글을 작성합니다
  • content : 답변 내용 (필수)
  • commentId : 대상 댓글 ID (필수)

기타 작업

• get_kibela_groups - 그룹 목록 가져오기
  • first : 앞의 레코드 수 (선택 사항)
  • last : 뒤부터의 레코드 수 (선택 사항)
• get_kibela_feed_sections - 피드 섹션 목록 가져오기
  • kind : 피드 유형(필수)
  • groupId : 그룹 ID (필수)

사용 가능한 프롬프트

검토 프롬프트

URL을 입력으로 받아 지정된 메모를 검토합니다.

입력 스키마:

검색 프롬프트

쿼리를 입력으로 받아 관련 정보를 검색합니다.

입력 스키마:

관련 메모 프롬프트

URL을 입력으로 받아 관련 메모를 탐색합니다.

입력 스키마:

댓글 프롬프트 반영

URL을 입력으로 받아서 주석에 반영합니다.

입력 스키마:

사용자 정의

다음 형식으로 JSON 파일을 준비하여 도구 설명과 프롬프트를 사용자 정의할 수 있습니다.

도구 및 프롬프트 키는 server.ts 참조하세요.

그리고 다음과 같이 컨테이너에 장착합니다.

개발

MCP Inspector로 테스트

특허

이 패키지는 MIT 라이선스 조건에 따라 라이선스가 부여되었습니다.