키벨라 MCP 서버

Kibela API 통합을 위한 MCP 서버 구현으로 LLM이 Kibela 콘텐츠와 상호 작용할 수 있습니다.

특징

• 고급 필터로 노트 검색

• 최신 노트를 받으세요

• 메모 내용 및 댓글 받기

• 그룹 및 폴더 관리

• 좋아요/싫어요 메모

• 사용자 목록

• 메모 첨부 파일 보기

• 최근에 본 노트 보기

• 경로별로 메모 가져오기

Related MCP server: note.com MCP Server

구성

환경 변수

• KIBELA_TEAM : Kibela 팀 이름 (필수)

• KIBELA_TOKEN : Kibela API 토큰(필수)

커서 통합

~/.cursor/mcp.json 에 다음을 추가합니다.

지엑스피1

대신 docker를 사용하고 싶다면

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

도구

키벨라_검색_노트

주어진 쿼리로 Kibela 노트 검색

• 입력:

  • query (문자열): 검색 쿼리

  • coediting (부울, 선택 사항): 공동 편집 상태별 필터링

  • isArchived (부울, 선택 사항): 보관 상태로 필터링

  • sortBy (문자열, 선택 사항): (RELEVANT, CONTENT_UPDATED_AT)로 정렬

  • userIds (string[], 선택 사항): 사용자 ID로 필터링

  • folderIds (string[], 선택 사항): 폴더 ID로 필터링

• 반환: ID, 제목, URL, 작성자, 그룹 등이 포함된 일치하는 메모 목록

키벨라_내_노트_받기

Kibela의 최신 노트를 받아보세요

• 입력:

  • limit (숫자, 선택 사항): 가져올 노트 수(기본값: 15)

• 반환: 작성자 정보가 포함된 최신 메모 목록

키벨라_겟_노트_콘텐츠

특정 노트의 내용과 코멘트를 받아보세요

• 입력:

  • id (문자열): 메모 ID

  • include_image_data (부울, 선택 사항): 응답에 이미지 데이터 URL을 포함할지 여부(기본값: false)

• 반환: HTML, 주석, 첨부 파일, 그룹, 폴더 등을 포함한 전체 메모 콘텐츠

키벨라_겟_그룹스

접근 가능한 그룹 목록 가져오기

• 입력: 없음

• 반환: 개인 정보 설정 및 권한과 같은 세부 정보가 포함된 그룹 목록

키벨라_그룹_폴더 가져오기

그룹으로 폴더 가져오기

• 입력:

  • groupId (문자열): 그룹 ID

  • parentFolderId (문자열, 선택 사항): 중첩된 폴더의 상위 폴더 ID

• 반환: 메모와 메타데이터가 포함된 폴더 목록

키벨라_그룹_노트_받기

어떤 폴더에도 첨부되지 않은 그룹의 노트를 가져옵니다.

• 입력:

  • groupId (문자열): 그룹 ID

• 반환: 작성자 정보가 포함된 메모 목록(마지막 업데이트 시간 기준)

키벨라_폴더_노트_받기

폴더에 메모 가져오기

• 입력:

  • folderId (문자열): 폴더 ID

• 반환: 작성자 정보가 포함된 메모 목록(마지막 업데이트 시간 기준)

키벨라_겟_유저스

사용자 목록 가져오기

• 입력: 없음

• 반환: ID, 계정 및 실명이 있는 사용자 목록

키벨라_좋아요_노트

메모처럼

• 입력:

  • noteId (문자열): 노트 ID

• 반환: 좋아요 목록이 업데이트되었습니다.

키벨라_싫어요_노트

노트와는 달리

• 입력:

  • noteId (문자열): 노트 ID

• 반환: 좋아요 목록이 업데이트되었습니다.

키벨라_최근_본_노트_받기

최근 본 노트를 받으세요

• 입력:

  • limit (숫자, 선택): 가져올 노트 수(최대 15개)

• 반환: 작성자 정보가 포함된 최근 본 노트 목록

키벨라_경로에서_노트_가져오기

경로 또는 URL로 메모 내용 가져오기

• 입력:

  • path (문자열): 메모 경로(예: '/group/folder/note') 또는 전체 Kibela URL(예: ' https://team.kibe.la/notes/123 ')

  • include_image_data (부울, 선택 사항): 응답에 이미지 데이터 URL을 포함할지 여부(기본값: false)

• 반환: HTML, 주석, 첨부 파일, 그룹, 폴더 등을 포함한 전체 메모 콘텐츠

지역 개발

소스에서 실행

1. 저장소를 복제합니다

2. 종속성 설치: npm install

환경 설정

로컬 개발을 위해 ~/.cursor/mcp.json 업데이트하세요.

{
    "mcpServers": {
        "kibela": {
            "command": "node",
            "args": ["path/to/mcp-kibela-server/dist/src/index.js"],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

MCP 검사관

npx @modelcontextprotocol/inspector node ./dist/src/index.js

그리고 환경을 설정하세요

도커

로컬로 빌드하고 실행:

docker build -t mcp-kibela-server .

그런 다음 이 구성을 사용하세요.

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "mcp-kibela-server"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

SSE 전송의 경우 서버 URL이 http://localhost:3000/sse 로 설정되어 있는지 확인하세요.

기타 제품

• 키벨라용 vscode 확장 프로그램