kibela/kibela-mcp-server

키벨라 MCP 계정 관리

Kibela MCP 서버는 Kibela를 위한 모형 Context 의정서 (MCP) 서버입니다.

개요

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

MCP에 공개적으로 사용할 수 있는 GraphQL API만 도구로 구현됩니다.

사용 케이스

• Kibela 정보 요청
• Kibela의 폴더 및 기사 구성
• AI를 사용하여 Kibela와 쓰기

요구 사항

1. 도커는 설치됩니다
2. 도커는 실행되어야 합니다
3. Kibela 접근 토큰은 발행됩니다
4. MCP 클라이언트를 실행하는 신청은 설치되어야 합니다

설치

예제: Claude 데스크탑

다음 구성을 claude_desktop_config.json로 작성합니다. Kibela 기원과 접근 토큰을 환경 변수로 설정합니다.

도커 없음

그런 다음 실행 명령으로 스크립트를 설정합니다. 이 시점에서 스크립트의 경로가 절대적이다.

사용 가능한 도구

참고 가동

• search_kibela_note - 검색 노트

• query: 키워드 검색 (필수)

• resources: 자원 유형 필터 (선택 사항)

• coediting: Co-editing flag (선택 사항)

Overview

Kibela MCP Server is currently available only as a local server using STDIO and can be used with any MCP client such as Claude Desktop or VSCode.

Only those GraphQL APIs that are publicly available and suitable for MCP are implemented as tools.

Use Cases

• Ask about information in Kibela
• Organize folders and articles in Kibela
• Using AI to help you write with Kibela

Requirements

1. Docker is installed
2. Docker must be running
3. Kibela access tokens is issued
4. An application that implements the MCP client must be installed

Installation

Example: Claude Desktop

Write the following configuration to claude_desktop_config.json. Set the Kibela origin and access token as environment variables.

{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "KIBELA_ORIGIN",
        "-e",
        "KIBELA_ACCESS_TOKEN",
        "ghcr.io/kibela/kibela-mcp-server"
      ],
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

No Docker

Then set the script as the execution command. At this time, make sure that the path to the script is absolute.

{
  "mcpServers": {
    "kibela": {
      "command": "/path/to/kibela-mcp-server/bin/cli.mjs",
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

Available Tools

Note Operations

• search_kibela_note - Search notes

  • query: Search keyword (required)
  • resources: Resource type filter (optional)
  • coediting: Co-editing flag (optional)
  • updated: Update date range (optional)
  • groupIds: Group ID filter (optional)
  • folderIds: Folder ID filter (optional)
  • likerIds: Liker user ID filter (optional)
  • isArchived: Archive flag (optional)
  • sortBy: Sort order (optional)

• get_kibela_note_by_relay_id - Get a note by Relay ID

  • id: Note’s Relay ID (required)

• get_kibela_note_from_path_or_url - Get a note from path or URL

  • path: Note’s path or URL (required)

• get_kibela_notes - Get notes in a folder

  • folderId: Folder ID (required)