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

• `get_kibela_note_by_relay_id` - Get a note by Relay ID

• `get_kibela_note_from_path_or_url` - Get a note from path or URL

• `get_kibela_notes` - Get notes in a folder

• `create_kibela_note` - Create a new note

• `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

• `get_kibela_folder_by_relay_id` - Get a folder by Relay ID

• `get_kibela_folder_from_path_or_url` - Get a folder from path or URL

• `get_kibela_folders` - Get folder list

• `create_kibela_folder` - Create a new folder

• `move_kibela_note_to_another_folder` - Move a note to another folder

• `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

• `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

• `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;
}

Related Note Prompt

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.