概要
Kibela MCP サーバーは現在、STDIO を使用するローカル サーバーとしてのみ使用可能で、Claude Desktop や VSCode などの任意の MCP クライアントで使用できます。
公開されており、MCP に適した GraphQL API のみがツールとして実装されています。
Related MCP server: MCP Toolkit
ユースケース
キベラの情報について尋ねる
Kibelaでフォルダと記事を整理する
KibelaでAIを活用してライティングを支援
要件
インストール
例: クロードデスクトップ
claude_desktop_config.jsonに以下の設定を記述します。Kibelaのオリジンとアクセストークンを環境変数として設定します。
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"-e",
"KIBELA_ORIGIN",
"-e",
"KIBELA_ACCESS_TOKEN",
"ghcr.io/kibela/kibela-mcp-server"
],
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}ドッカーなし
次に、スクリプトを実行コマンドとして設定します。このとき、スクリプトへのパスが絶対パスであることを確認してください。
{
"mcpServers": {
"kibela": {
"command": "/path/to/kibela-mcp-server/bin/cli.mjs",
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}利用可能なツール
ノート操作
search_kibela_note- ノートを検索query: 検索キーワード（必須）resources: リソースタイプフィルター（オプション）coediting: 共同編集フラグ（オプション）updated: 更新日の範囲（オプション）groupIds: グループIDフィルター（オプション）folderIds: フォルダーIDフィルター（オプション）likerIds: ライカー ユーザー ID フィルター (オプション)isArchived: アーカイブフラグ（オプション）sortBy: 並べ替え順（オプション）
get_kibela_note_by_relay_id- リレーIDでメモを取得するid: ノートのリレーID（必須）
get_kibela_note_from_path_or_url- パスまたは URL からメモを取得するpath: ノートのパスまたはURL（必須）
get_kibela_notes- フォルダー内のメモを取得するfolderId: フォルダーID（必須）first: 先頭からのレコード数（オプション）last: 後ろからのレコード数（オプション）
create_kibela_note- 新しいメモを作成するtitle: ノートのタイトル（必須）content: メモの内容（必須）draft: ドラフトフラグ（オプション）groupIds: 所属するグループIDのリスト（必須）folders: フォルダ情報（オプション）groupId: グループIDfolderName: フォルダ名
update_kibela_note_content- ノートの内容を更新するid: ノートID（必須）newContent: 新しいコンテンツ（必須）baseContent: オリジナルコンテンツ（必須）
フォルダー操作
search_kibela_folder- フォルダを検索query: 検索キーワード（必須）
get_kibela_folder_by_relay_id- リレーIDでフォルダーを取得するid: フォルダのリレーID（必須）first: 先頭からのレコード数（オプション）
get_kibela_folder_from_path_or_url- パスまたは URL からフォルダーを取得するpath: フォルダのパスまたはURL（必須）first: 先頭からのレコード数（オプション）
get_kibela_folders- フォルダーリストを取得するfirst: 先頭からのレコード数（オプション）last: 後ろからのレコード数（オプション）
create_kibela_folder- 新しいフォルダを作成するgroupId: グループID（必須）fullName: フォルダのフルパス名（必須）
move_kibela_note_to_another_folder- メモを別のフォルダに移動するid: ノートID（必須）fromFolder: ソースフォルダ情報（必須）groupId: グループIDfolderName: フォルダ名
toFolder: 保存先フォルダ情報（必須）groupId: グループIDfolderName: フォルダ名
attach_kibela_note_to_folder- メモをフォルダーに関連付けるid: ノートID（必須）folder: フォルダ情報（必須）groupId: グループIDfolderName: フォルダ名
コメント操作
create_kibela_comment- ノートにコメントを作成するcontent: コメント内容（必須）noteId: 対象ノートID（必須）
create_kibela_comment_reply- コメントへの返信を作成するcontent: 返信内容（必須）commentId: 対象コメントID（必須）
その他の操作
get_kibela_groups- グループリストを取得するfirst: 先頭からのレコード数（オプション）last: 後ろからのレコード数（オプション）
get_kibela_feed_sections- フィードセクションリストを取得するkind: フィードの種類（必須）groupId: グループID（必須）
利用可能なプロンプト
レビュープロンプト
URL を入力として受け取り、指定されたメモを確認します。
入力スキーマ:
{
url: string; // URL format
}検索プロンプト
クエリを入力として受け取り、関連する情報を検索します。
入力スキーマ:
{
query: string;
}関連ノートプロンプト
URL を入力として受け取り、関連するメモを調べます。
入力スキーマ:
{
url: string; // URL format
}コメントプロンプトを反映
URL を入力として受け取り、そのコメントをメモに反映します。
入力スキーマ:
{
url: string; // URL format
}カスタマイズ
次の形式の JSON ファイルを用意することで、ツールの説明とプロンプトをカスタマイズできます。
ツールとプロンプトのキーについては、 server.ts参照してください。
{
"tools": {
"search_kibela_note": {
"description": "New description"
}
},
"prompts": {
"review": {
"prompt": "New review prompt"
}
}
}そして、次のようにコンテナにマウントします。
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"-e",
"KIBELA_ORIGIN",
"-e",
"KIBELA_ACCESS_TOKEN",
"-v",
"/path/to/kibela-mcp-server-config.json:/usr/src/app/kibela-mcp-server-config.json",
"ghcr.io/kibela/kibela-mcp-server"
],
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}発達
docker compose run mcp pnpm installdocker compose upMCP Inspectorによるテスト
npx @modelcontextprotocol/inspector \
-e KIBELA_ORIGIN=https://your-subdomain.kibe.la \
-e KIBELA_ACCESS_TOKEN=*** \
docker compose exec mcp bin/cli.mjsライセンス
このパッケージは、 MITライセンスの条件に基づいてライセンスされます。
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to authenticate as an admin.