概要

Kibela MCP サーバーは現在、STDIO を使用するローカル サーバーとしてのみ使用可能で、Claude Desktop や VSCode などの任意の MCP クライアントで使用できます。

公開されており、MCP に適した GraphQL API のみがツールとして実装されています。

ユースケース

• キベラの情報について尋ねる
• Kibelaでフォルダと記事を整理する
• KibelaでAIを活用してライティングを支援

要件

1. Dockerがインストールされている
2. Dockerが実行されている必要があります
3. Kibelaアクセストークンが発行される
4. MCPクライアントを実装したアプリケーションをインストールする必要があります

インストール

例: クロードデスクトップ

claude_desktop_config.jsonに以下の設定を記述します。Kibelaのオリジンとアクセストークンを環境変数として設定します。

ドッカーなし

次に、スクリプトを実行コマンドとして設定します。このとき、スクリプトへのパスが絶対パスであることを確認してください。

利用可能なツール

ノート操作

• 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 : グループID
    • folderName : フォルダ名
• 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 : グループID
    • folderName : フォルダ名
  • toFolder : 保存先フォルダ情報（必須）
    • groupId : グループID
    • folderName : フォルダ名
• attach_kibela_note_to_folder - メモをフォルダーに関連付ける
  • id : ノートID（必須）
  • folder : フォルダ情報（必須）
    • groupId : グループID
    • folderName : フォルダ名

コメント操作

• 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 を入力として受け取り、関連するメモを調べます。

入力スキーマ:

コメントプロンプトを反映

URL を入力として受け取り、そのコメントをメモに反映します。

入力スキーマ:

カスタマイズ

次の形式の JSON ファイルを用意することで、ツールの説明とプロンプトをカスタマイズできます。

ツールとプロンプトのキーについては、 server.ts参照してください。

そして、次のようにコンテナにマウントします。

発達

MCP Inspectorによるテスト

ライセンス

このパッケージは、 MITライセンスの条件に基づいてライセンスされます。