README.md•3.72 kB
# mcp-kibela 🗒️
[](https://smithery.ai/server/@kj455/mcp-kibela)
[](https://www.npmjs.com/package/@kj455/mcp-kibela)
[](https://opensource.org/licenses/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](https://support.kibe.la/hc/ja/articles/360036089931-API%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%AE%E5%8F%96%E5%BE%97%E6%96%B9%E6%B3%95%E3%82%92%E6%95%99%E3%81%88%E3%81%A6%E3%81%8F%E3%81%A0%E3%81%95%E3%81%84))
- Git (if building from source)
## Installation 🛠️
### Usage with Cursor
```json
{
"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
```json
{
"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
```json
{
"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
```bash
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.
```bash
npm run build:watch
```
2. Use `npx @modelcontextprotocol/inspector` to inspect the MCP server.
```bash
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js
```
## License 📄
MIT