mcpField
M
mcp-kibela 🗒️

mcp-kibela 🗒️

Local
github.com/kj455Memory & Knowledge13Updated 82w ago
Repository

About mcp-kibela 🗒️

mcp-kibela is an MCP server that lets AI assistants search and reference content stored in Kibela. It supports retrieving and editing notes, for teams using Kibela as a source of information.

Key features

  1. 01Search notes by keyword
  2. 02Fetch recent personal notes
  3. 03Read note content and comments
  4. 04Retrieve notes by path
  5. 05Create notes
  6. 06Update note content

Use cases

  1. 01Find Kibela notes by keyword
  2. 02Review recent notes
  3. 03Retrieve a note using its ID or path
  4. 04Create or update a Kibela note

MCP support

Exposes Kibela note search, retrieval, creation, and update capabilities to MCP clients. Access requires a Kibela team name and API token.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "<KIBELA_TEAM>",
        "KIBELA_TOKEN": "<KIBELA_TOKEN>"
      }
    }
  }
}
Run commanddocker run -i --rm -e KIBELA_TEAM -e KIBELA_TOKEN ghcr.io/kj455/mcp-kibela:latest
Environment variables to set
KIBELA_TEAM
KIBELA_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/kj455/mcp-kibela:latest

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-kibela 🗒️

smithery badge npm version License: 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.)
  • Kibela Access Token (How to get a token)
  • Git (if building from source)

Installation 🛠️

Usage with Cursor
{
  "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
{
  "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
{
  "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
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.
npm run build:watch
  1. Use npx @modelcontextprotocol/inspector to inspect the MCP server.
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

License 📄

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.