Kibela

MCP server implementation that enables AI assistants to search and reference Kibela content

typescript

12

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kj455-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",
        "KIBELA_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

You can connect an AI assistant to Kibela content through an MCP server that exposes search, notes, and content retrieval capabilities. This setup lets you securely query Kibela data from your AI workspace and reference notes, content, and comments in conversations.

How to use

Use an MCP client to connect to the Kibela MCP server. You can search notes by keywords, fetch your latest notes, retrieve note content and comments by ID, locate notes by path, and create or update notes. When integrated with an AI assistant, you gain fast access to relevant Kibela content during conversations, enabling informed responses and quick references.

How to install

Prerequisites you need before running the server include Docker, a Kibela team name, and a Kibela API token. You also need an MCP client compatible with your workflow.

Step 1: Prepare your Kibela credentials and environment

KIBELA_TEAM: Your Kibela team name (the segment from your Kibela team URL). Example: your-team-name from https://your-team-name.kibe.la.
KIBELA_TOKEN: Your Kibela API token.

Step 2: Run the MCP Kibela server with Docker

docker run -i --rm \
  -e KIBELA_TEAM \
  -e KIBELA_TOKEN \
  ghcr.io/kj455/mcp-kibela:latest

Notes on configuration and security

The Kibela team name and API token are provided to the container as environment variables. Keep these credentials secure and avoid sharing them in public or insecure channels. If you are integrating with an IDE or editor, configure your MCP client to pass the same environment variables to the running server.

Troubleshooting

If the server fails to start, verify that Docker is running and that the Kibela credentials are correct. Check that the environment variables are being passed to the container and that the MCP client can reach the running server.

Available tools

Note Search

Search Kibela notes by keywords to quickly locate relevant content.

My Notes

Fetch your latest notes from Kibela.

Note Content

Retrieve note content and comments by ID to view full details.

Note by Path

Get note content by its path for direct access.

Create Note

Create a new Kibela note from within the MCP context.

Update Note Content

Update the content of an existing Kibela note by its ID.