mcp-kibela MCP Server

README

mcp-kibela 🗒️

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

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

npm run build:watch

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

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

License 📄

MIT

mcp-kibela FAQ

How does mcp-kibela authenticate access to Kibela content?

mcp-kibela uses secure API tokens or credentials to authenticate and authorize AI assistants to access Kibela data safely.

Can mcp-kibela create and update notes in Kibela?

Yes, it supports creating new notes and updating existing note content by note ID, enabling dynamic content management.

What types of Kibela content can mcp-kibela retrieve?

It can retrieve note content, comments, and user-specific notes by ID or path, providing comprehensive access to Kibela knowledge.

Is mcp-kibela compatible with multiple AI models?

Yes, it is designed to work with various LLM providers like Claude, OpenAI, and Gemini, ensuring broad compatibility.

What are the prerequisites for running mcp-kibela?

You need Node.js (v18 or higher) and appropriate Kibela API credentials to run the server.

How does mcp-kibela handle note searching?

It allows keyword-based search across Kibela notes, enabling efficient retrieval of relevant documents.

Can mcp-kibela fetch notes specific to a user?

Yes, it can fetch the latest notes created or owned by the authenticated user.

Is the mcp-kibela server open source?

Yes, it is open source under the MIT license, allowing customization and community contributions.