mcp-kibela 🗒️

1# mcp-kibela 🗒️
2 
3[![smithery badge](https://smithery.ai/badge/@kj455/mcp-kibela)](https://smithery.ai/server/@kj455/mcp-kibela)
4[![npm version](https://badge.fury.io/js/@kj455%2Fmcp-kibela.svg)](https://www.npmjs.com/package/@kj455/mcp-kibela)
5[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6 
7A 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.
8 
9## Features 🚀
10 
11The mcp-kibela server provides the following features:
12 
13- **Note Search**: Search Kibela notes by keywords
14- **My Notes**: Fetch your latest notes
15- **Note Content**: Get note content and comments by ID
16- **Note by Path**: Get note content by path
17- **Create Note**: Create a new note
18- **Update Note Content**: Update note content by note id
19 
20---
21 
22## Prerequisites 📋
23 
24Before you begin, ensure you have:
25 
26- Node.js (v18 or higher)
27- MCP Client (Claude Desktop, Cursor, etc.)
28- 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))
29- Git (if building from source)
30 
31## Installation 🛠️
32 
33### Usage with Cursor
34 
35```json
36{
37  "kibela": {
38    "command": "docker",
39    "args": [
40      "run",
41      "-i",
42      "--rm",
43      "-e",
44      "KIBELA_TEAM",
45      "-e",
46      "KIBELA_TOKEN",
47      "ghcr.io/kj455/mcp-kibela:latest"
48    ],
49    "env": {
50      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
51      "KIBELA_TOKEN": "your-token"
52    }
53  }
54}
55```
56 
57### Usage with VSCode
58 
59```json
60{
61  "mcp": {
62    "inputs": [
63      {
64        "type": "promptString",
65        "id": "kibela_team",
66        "description": "Kibela team name",
67        "password": false
68      },
69      {
70        "type": "promptString",
71        "id": "kibela_token",
72        "description": "Kibela token",
73        "password": true
74      },
75    ],
76    "servers": {
77      "kibela": {
78        "command": "docker",
79        "args": [
80          "run",
81          "-i",
82          "--rm",
83          "-e",
84          "KIBELA_TEAM",
85          "-e",
86          "KIBELA_TOKEN",
87          "ghcr.io/kj455/mcp-kibela:latest"
88        ],
89        "env": {
90          "KIBELA_TEAM": "${input:kibela_team}",
91          "KIBELA_TOKEN": "${input:kibela_token}"
92        }
93      }
94    }
95  }
96}
97```
98 
99 
100### Usage with Claude Desktop
101 
102```json
103{
104  "mcpServers": {
105    "mcp-kibela": {
106      "command": "docker",
107      "args": [
108        "run",
109        "-i",
110        "--rm",
111        "-e",
112        "KIBELA_TEAM",
113        "-e",
114        "KIBELA_TOKEN",
115        "ghcr.io/kj455/mcp-kibela:latest"
116      ],
117      "env": {
118        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
119        "KIBELA_TOKEN": "your-token"
120      }
121    }
122  }
123}
124```
125 
126### Using Smithery
127 
128```bash
129npx -y @smithery/cli install @kj455/mcp-kibela --client claude
130```
131 
132## Environment Variables
133 
134The following environment variables are required:
135 
136- `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
137- `KIBELA_TOKEN`: Your Kibela API token (required)
138 
139## Contributing
140 
141Any contributions are welcome!
142 
143## Development
144 
1451. Use `npm run build:watch` to build the project in watch mode.
146 
147```bash
148npm run build:watch
149```
150 
1512. Use `npx @modelcontextprotocol/inspector` to inspect the MCP server.
152 
153```bash
154npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js
155```
156 
157 
158## License 📄
159 
160MIT
161