mcp-キベラ🗒️
AIアシスタントがKibelaコンテンツを検索・参照できるようにする、モデルコンテキストプロトコル（MCP）サーバー実装。この設定により、ClaudeのようなAIモデルはKibelaに保存された情報に安全にアクセスできるようになります。
機能🚀
mcp-kibela サーバーは次の機能を提供します。
- ノート検索: キーワードでKibelaノートを検索
- マイノート: 最新のノートを取得する
- ノートコンテンツ: IDでノートコンテンツとコメントを取得します
- パスによるノート: パスごとにノートの内容を取得します
- ノートを作成: 新しいノートを作成する
- ノートの内容を更新: ノートIDでノートの内容を更新します
前提条件 📋
始める前に、次のものを用意してください。
- Node.js (v18以上)
- MCP クライアント (Claude Desktop、Cursor など)
- Kibela アクセストークン（ トークンの取得方法）
- Git (ソースからビルドする場合)
インストール 🛠️
カーソルとの使用
{
"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"
}
}
}
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}"
}
}
}
}
}
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"
}
}
}
}
鍛冶屋を使う
npx -y @smithery/cli install @kj455/mcp-kibela --client claude
環境変数
次の環境変数が必要です。
KIBELA_TEAM : Kibelaチーム名（必須）。KibelaチームページのURLから確認できます。例：https://[チーム名].kibe.laKIBELA_TOKEN : Kibela API トークン (必須)
貢献
どのような貢献でも歓迎します!
発達
npm run build:watch使用して、プロジェクトをウォッチ モードでビルドします。
npx @modelcontextprotocol/inspectorを使用して MCP サーバーを検査します。
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js
ライセンス📄
マサチューセッツ工科大学