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 🛠️

Choose one of the following installation methods:

Using Smithery

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

Using npm Package

npm install -g @kj455/mcp-kibela

Building from Source

git clone https://github.com/kj455/mcp-kibela.git
cd mcp-kibela
npm install
npm run build

Configuration ⚙️

Claude Desktop

If you use Smithery, you don't need to add this.

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "kibela": {
      "command": "mcp-kibela",
      "env": {
        "KIBELA_TEAM": "your-team-name",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

If you use asdf

You will need this special configuration:

{
  "mcpServers": {
    "kibela": {
      "command": "/bin/bash",
      "args": ["-c", "npx -y @kj455/mcp-kibela@latest"],
      "env": {
        "KIBELA_TEAM": "your-team-name",
        "KIBELA_TOKEN": "your-token",
        "PATH": "/path/to/.asdf/shims:/usr/bin:/bin",
        "ASDF_DIR": "/opt/homebrew/opt/asdf/libexec",
        "ASDF_DATA_DIR": "/path/to/.asdf",
        "ASDF_NODEJS_VERSION": "your-nodejs-version"
      }
    }
  }
}

If you built from source

You will need to modify the command and args like this:

{
  "mcpServers": {
    "kibela": {
      "command": "/bin/bash",
      "args": ["-c", "node dist/index.js"]
      // ... other env configurations remain the same
    }
  }
}

Cursor

Currently, ONLY build from source is supported.

After building from source, you need to modify Cursor Settings.

Cursor Settings -> Features -> MCP Servers -> Add new MCP server

Name: kibela (or whatever you want)
Type: command
Command: env KIBELA_TEAM=your_team_name KIBELA_TOKEN=your_token node /path/to/mcp-kibela/dist/index.js

Environment Variables

The following environment variables are required:

KIBELA_TEAM: Your Kibela team name (required)
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