Kibela MCP Server

Official
by kibela

Integrations

  • Provides containerized deployment of the MCP server through Docker, with environment variable configuration for Kibela authentication.

  • Interacts with Kibela through its GraphQL API, allowing operations like searching notes, managing folders, creating and updating notes, and handling comments within the Kibela knowledge management platform.

  • Supports development setup using pnpm package manager, with commands for installation and dependency management.

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)
    • first: Number of records from front (optional)
    • last: Number of records from back (optional)
  • create_kibela_note - Create a new note
    • title: Note title (required)
    • content: Note content (required)
    • draft: Draft flag (optional)
    • groupIds: List of group IDs to belong to (required)
    • folders: Folder information (optional)
      • groupId: Group ID
      • folderName: Folder name
  • update_kibela_note_content - Update note content
    • id: Note ID (required)
    • newContent: New content (required)
    • baseContent: Original content (required)

Folder Operations

  • search_kibela_folder - Search folders
    • query: Search keyword (required)
  • get_kibela_folder_by_relay_id - Get a folder by Relay ID
    • id: Folder's Relay ID (required)
    • first: Number of records from front (optional)
  • get_kibela_folder_from_path_or_url - Get a folder from path or URL
    • path: Folder's path or URL (required)
    • first: Number of records from front (optional)
  • get_kibela_folders - Get folder list
    • first: Number of records from front (optional)
    • last: Number of records from back (optional)
  • create_kibela_folder - Create a new folder
    • groupId: Group ID (required)
    • fullName: Full path name of the folder (required)
  • move_kibela_note_to_another_folder - Move a note to another folder
    • id: Note ID (required)
    • fromFolder: Source folder information (required)
      • groupId: Group ID
      • folderName: Folder name
    • toFolder: Destination folder information (required)
      • groupId: Group ID
      • folderName: Folder name
  • attach_kibela_note_to_folder - Associate a note with a folder
    • id: Note ID (required)
    • folder: Folder information (required)
      • groupId: Group ID
      • folderName: Folder name

Comment Operations

  • create_kibela_comment - Create a comment on a note
    • content: Comment content (required)
    • noteId: Target note ID (required)
  • create_kibela_comment_reply - Create a reply to a comment
    • content: Reply content (required)
    • commentId: Target comment ID (required)

Other Operations

  • get_kibela_groups - Get group list
    • first: Number of records from front (optional)
    • last: Number of records from back (optional)
  • get_kibela_feed_sections - Get feed section list
    • kind: Feed type (required)
    • groupId: Group ID (required)

Available Prompts

Review Prompt

Takes a URL as input and reviews the specified note.

Input schema:

{ url: string; // URL format }

Search Prompt

Takes a query as input and searches for relevant information.

Input schema:

{ query: string; }

Takes a URL as input and explore the related note.

Input schema:

{ url: string; // URL format }

Reflect Comment Prompt

Takes a URL as input and reflect its comment to note.

Input schema:

{ url: string; // URL format }

Customization

You can customize the tool description and prompt by preparing a JSON file in the following format.

See server.ts for tool and prompt keys.

{ "tools": { "search_kibela_note": { "description": "New description" } }, "prompts": { "review": { "prompt": "New review prompt" } } }

And then mount it to the container as follows:

{ "mcpServers": { "kibela": { "command": "docker", "args": [ "run", "-i", "-e", "KIBELA_ORIGIN", "-e", "KIBELA_ACCESS_TOKEN", "-v", "/path/to/kibela-mcp-server-config.json:/usr/src/app/kibela-mcp-server-config.json", "ghcr.io/kibela/kibela-mcp-server" ], "env": { "KIBELA_ORIGIN": "https://your-subdomain.kibe.la", "KIBELA_ACCESS_TOKEN": "***" } } } }

Development

docker compose run mcp pnpm install
docker compose up

Testing with MCP Inspector

npx @modelcontextprotocol/inspector \ -e KIBELA_ORIGIN=https://your-subdomain.kibe.la \ -e KIBELA_ACCESS_TOKEN=*** \ docker compose exec mcp bin/cli.mjs

License

This package is licensed under the terms of the MIT license.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that allows AI applications to interact with Kibela knowledge bases, enabling users to search, create, update, and organize content through natural language.

  1. Use Cases
    1. Requirements
      1. Installation
        1. Example: Claude Desktop
        2. No Docker
      2. Available Tools
        1. Note Operations
        2. Folder Operations
        3. Comment Operations
        4. Other Operations
      3. Available Prompts
        1. Review Prompt
        2. Search Prompt
        3. Related Note Prompt
        4. Reflect Comment Prompt
      4. Customization
        1. Development
          1. Testing with MCP Inspector
        2. License

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
            Last updated -
            9
            Python
            MIT License
          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that enables AI models to interact with SourceSync.ai's knowledge management platform for managing documents, ingesting content from various sources, and performing semantic searches.
            Last updated -
            25
            14
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
            Last updated -
            19
            TypeScript
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.
            Last updated -
            55
            TypeScript
            MIT License

          View all related MCP servers

          ID: 6utn596w3i