kj455/mcp-kibela

CategoryWeb
AuthorCommunity
Stars497
PricingFree

Overview

The mcp-kibela tool bridges the gap between LLMs and Kibela, a cloud-based personal knowledge management system. For developers, this means your AI agent can now perform CRUD operations on your structured personal data, transforming a static knowledge base into a dynamic context source. Instead of manually pasting notes into a prompt, you can delegate information retrieval and updates to the model via the MCP standard. This is particularly useful for automating personal workflows, managing project snippets, or maintaining a persistent long-term memory for AI assistants without building a custom database wrapper from scratch.

Highlights

  • Directly syncs AI context with Kibela cloud storage
  • Enables automated retrieval of personal structured notes
  • Standardized MCP integration for rapid local deployment
  • Supports real-time updates to your personal knowledge base

Full Documentation

mcp-kibela 🗒️

![smithery badge](https://smithery.ai/server/@kj455/mcp-kibela)
![npm version](https://www.npmjs.com/package/@kj455/mcp-kibela)
![License: MIT](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server implementation that enables AI assistants to search and reference Kibela content. This setup allows AI models like Claude to securely access information stored in Kibela.

Features 🚀

The mcp-kibela server provides the following features:

  • Note Search: Search Kibela notes by keywords
  • My Notes: Fetch your latest notes
  • Note Content: Get note content and comments by ID
  • Note by Path: Get note content by path
  • Create Note: Create a new note
  • Update Note Content: Update note content by note id

---

Prerequisites 📋

Before you begin, ensure you have:

  • Node.js (v18 or higher)
  • MCP Client (Claude Desktop, Cursor, etc.)
  • Git (if building from source)

Installation 🛠️

Usage with Cursor

json
{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

Usage with VSCode

json
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

Usage with Claude Desktop

json
{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

Using Smithery

bash
npx -y @smithery/cli install @kj455/mcp-kibela --client claude

Environment Variables

The following environment variables are required:

  • KIBELA_TEAM: Your Kibela team name (required). You can find it from the URL of your Kibela team page. e.g. https://[team-name].kibe.la
  • KIBELA_TOKEN: Your Kibela API token (required)

Contributing

Any contributions are welcome!

Development

1. Use npm run build:watch to build the project in watch mode.

bash
npm run build:watch

2. Use npx @modelcontextprotocol/inspector to inspect the MCP server.

bash
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

License 📄

MIT

View official source
Join our Telegram