mcp-kibela
by kj455
mcp-kibela is a Model Context Protocol (MCP) server that allows AI assistants to securely search and reference content from Kibela. It enables AI models like Claude to access information stored in Kibela.
View on GitHub
Last updated: N/A
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.laKIBELA_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