Kibela MCP Server

Kibela MCP サーバー

LLM が Kibela のコンテンツを操作できるようにする、Kibela API 連携用の MCP サーバー実装です。

ヒント

この拡張機能は、graphql パッケージの buildClientSchema、getIntrospectionQuery、printSchema 関数を使用して GraphQL スキーマをイントロスペクションし、Kibela の API をリバースエンジニアリングします。詳しくはこちらをご覧ください

機能

• 高度なフィルターを使ってノートを検索
• 最新のノートを取得
• ノートの内容とコメントを取得
• グループとフォルダーを管理
• ノートにいいねする／取り消す
• ユーザー一覧を表示
• ノートの添付ファイルを表示
• 最近閲覧したノートを表示
• パスでノートを取得

設定

環境変数

• KIBELA_TEAM：Kibela のチーム名（必須）
• KIBELA_TOKEN：Kibela API トークン（必須）

Cursor との連携

~/.cursor/mcp.json に追加します。

{
    "mcpServers": {
        "kibela": {
            "command": "npx",
            "args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

Docker を使用する場合は、以下のようにします。

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

ツール

kibela_search_notes

指定したクエリで Kibela のノートを検索します。

• 入力：
  • query（string）：検索クエリ
  • coediting（boolean、任意）：共同編集の状態で絞り込みます
  • isArchived（boolean、任意）：アーカイブの状態で絞り込みます
  • sortBy（string、任意）：並べ替え方法（RELEVANT、CONTENT_UPDATED_AT）
  • userIds（string[]、任意）：ユーザー ID で絞り込みます
  • folderIds（string[]、任意）：フォルダー ID で絞り込みます
• 戻り値：ID、タイトル、URL、作成者、グループなどを含む、一致したノートの一覧

kibela_get_my_notes

Kibela から最新のノートを取得します。

• 入力：
  • limit（number、任意）：取得するノートの件数（デフォルト：15）
• 戻り値：作成者情報を含む、自分の最新ノートの一覧

kibela_get_note_content

特定のノートの内容とコメントを取得します。

• 入力：
  • id（string）：ノート ID
  • include_image_data（boolean、任意）：レスポンスに画像データ URL を含めるかどうか（デフォルト：false）
• 戻り値：HTML、コメント、添付ファイル、グループ、フォルダーなどを含むノートの全内容

kibela_get_groups

アクセス可能なグループの一覧を取得します。

• 入力：なし
• 戻り値：プライバシー設定や権限などの詳細を含むグループの一覧

kibela_get_group_folders

グループ内のフォルダーを取得します。

• 入力：
  • groupId（string）：グループ ID
  • parentFolderId（string、任意）：ネストされたフォルダーの親フォルダー ID
• 戻り値：ノートとメタデータを含むフォルダーの一覧

kibela_get_group_notes

フォルダーに属していない、グループ内のノートを取得します。

• 入力：
  • groupId（string）：グループ ID
• 戻り値：作成者情報を含む、最終更新日時順のノート一覧

kibela_get_folder_notes

フォルダー内のノートを取得します。

• 入力：
  • folderId（string）：フォルダー ID
  • limit（number、任意）：取得するノートの件数（デフォルト：100）
• 戻り値：作成者情報を含む、最終更新日時順のノート一覧

kibela_get_users

ユーザーの一覧を取得します。

• 入力：なし
• 戻り値：ID、アカウント名、氏名を含むユーザーの一覧

kibela_like_note

ノートにいいねします。

• 入力：
  • noteId（string）：ノート ID
• 戻り値：更新された「いいね」したユーザーの一覧

kibela_unlike_note

ノートのいいねを取り消します。

• 入力：
  • noteId（string）：ノート ID
• 戻り値：更新された「いいね」したユーザーの一覧

kibela_get_recently_viewed_notes

最近閲覧したノートを取得します

• 入力：
  • limit（数値、任意）：取得するノートの数（最大15）
• 戻り値：最近閲覧したノートの一覧と作成者情報

kibela_get_note_from_path

パスまたはURLでノートの内容を取得します

• 入力：
  • path（文字列）：ノートのパス（例：'/group/folder/note'）またはKibelaの完全なURL（例：'https://team.kibe.la/notes/123'）
  • include_image_data（ブール値、任意）：レスポンスに画像データURLを含めるかどうか（デフォルト：false）
• 戻り値：HTML、コメント、添付ファイル、グループ、フォルダーなどを含むノートの全内容

ローカル開発

ソースから実行する

1. リポジトリをクローンします
2. 依存関係をインストールします：npm install

環境のセットアップ

ローカル開発では、~/.cursor/mcp.jsonを更新してください：

{
    "mcpServers": {
        "kibela": {
            "command": "node",
            "args": ["path/to/mcp-kibela-server/dist/src/index.js"],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

MCP inspector

npx @modelcontextprotocol/inspector node ./dist/src/index.js

環境変数を設定してください

Docker

ローカルでビルドして実行します：

docker build -t mcp-kibela-server .

次に、この設定を使用してください：

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "mcp-kibela-server"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

SSEトランスポートの場合、サーバーURLがhttp://localhost:3000/sseに設定されていることを確認してください。

その他の製品

• kibela用vscode拡張機能