MCP Kibela

by kj455
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.

  1. Features 🚀
    1. Prerequisites 📋
      1. Installation 🛠️
        1. Usage with Cursor
        2. Usage with VSCode
        3. Usage with Claude Desktop
        4. Using Smithery
      2. Environment Variables
        1. Contributing
          1. Development
            1. License 📄
              ID: mc8brt77rn