Skip to main content
Glama
Kibela MCP Server

Kibela MCP Server

Kibela MCP サーバー

NPMバージョンNPMダウンロード ライセンス: MIT 鍛冶屋のバッジ Dockerイメージのビルドとプッシュ 糸くず

Kibela API 統合のための MCP サーバー実装。LLM が Kibela コンテンツと対話できるようにします。

特徴

  • 高度なフィルターでノートを検索

  • 最新のノートを入手する

  • メモの内容とコメントを取得する

  • グループとフォルダを管理する

  • いいね/いいね取り消しメモ

  • ユーザーをリストする

  • メモの添付ファイルを表示する

  • 最近閲覧したメモを表示する

  • パスでメモを取得

Related MCP server: note.com MCP Server

構成

環境変数

  • KIBELA_TEAM : Kibelaチーム名(必須)

  • KIBELA_TOKEN : Kibela API トークン (必須)

カーソル統合

~/.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ノートを検索

  • 入力:

    • query (文字列): 検索クエリ

    • coediting (ブール値、オプション): 共同編集ステータスでフィルタリング

    • isArchived (ブール値、オプション): アーカイブステータスでフィルタリング

    • sortBy (文字列、オプション): (RELEVANT、CONTENT_UPDATED_AT) で並べ替え

    • userIds (文字列[], オプション): ユーザーIDでフィルタリング

    • folderIds (文字列[], オプション): フォルダIDでフィルタリング

  • 戻り値: ID、タイトル、URL、作成者、グループなどが一致するノートのリスト

kibela_get_my_notes

Kibelaから最新のノートを入手

  • 入力:

    • limit (数値、オプション): 取得するノートの数 (デフォルト: 15)

  • 戻り値: 著者情報を含む最新のノートのリスト

キベラ_get_note_content

特定のメモの内容とコメントを取得する

  • 入力:

    • id (文字列): ノートID

    • include_image_data (ブール値、オプション): レスポンスに画像データの URL を含めるかどうか (デフォルト: false)

  • 返されるもの: HTML、コメント、添付ファイル、グループ、フォルダなどを含む完全なメモの内容

キベラ_get_groups

アクセス可能なグループのリストを取得する

  • 入力: なし

  • 戻り値: プライバシー設定や権限などの詳細を含むグループのリスト

kibela_get_group_folders

グループ内のフォルダを取得する

  • 入力:

    • groupId (文字列): グループID

    • parentFolderId (文字列、オプション): ネストされたフォルダの親フォルダID

  • 戻り値: メモとメタデータを含むフォルダーのリスト

kibela_get_group_notes

どのフォルダにも添付されていないグループ内のメモを取得する

  • 入力:

    • groupId (文字列): グループID

  • 戻り値: 最終更新時刻順に並べられた、著者情報付きのノートのリスト

kibela_get_folder_notes

フォルダ内のメモを取得する

  • 入力:

    • folderId (文字列): フォルダーID

  • 戻り値: 最終更新時刻順に並べられた、著者情報付きのノートのリスト

kibela_get_users

ユーザーのリストを取得する

  • 入力: なし

  • 戻り値: ID、アカウント、実名を持つユーザーのリスト

キベラいいねノート

メモのように

  • 入力:

    • noteId (文字列): ノートID

  • 戻り値: 更新されたいいねリスト

キベラのいいね

メモとは違って

  • 入力:

    • noteId (文字列): ノート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検査官

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

環境を設定する

ドッカー

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

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に設定されていることを確認します。

その他の製品

Available Tools

12 tools
kibela_get_folder_notesC

Get notes in a folder

Inputs: folderId (required), limit.

kibela_get_group_foldersC

Get folders in a group

Inputs: groupId (required), parentFolderId.

kibela_get_group_notesB

Get notes in a group that are not attached to any folder

Inputs: groupId (required).

kibela_get_groupsB

Get list of accessible groups

Inputs: no named parameters.

kibela_get_my_notesA

Get your latest notes from Kibela

Inputs: limit.

kibela_get_note_contentC

Get content and comments of a specific note

Inputs: id (required), include_image_data.

kibela_get_note_from_pathC

Get note content by its URL

Inputs: path (required), include_image_data.

kibela_get_recently_viewed_notesB

Get your recently viewed notes

Inputs: limit.

kibela_get_usersC

Get list of users

Inputs: no named parameters.

kibela_like_noteC

Like a note

Inputs: noteId (required).

kibela_search_notesB

Search Kibela notes with given query

Inputs: query (required), coediting, isArchived, sortBy, +2 more.

kibela_unlike_noteC

Unlike a note

Inputs: noteId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but some overlap exists between tools that retrieve notes in different contexts (e.g., get_note_content vs get_note_from_path) and between personal note lists (get_my_notes vs get_recently_viewed_notes). Descriptions help disambiguate, so the set is mostly clear.

    Naming Consistency5/5

    All tools follow a consistent pattern: 'kibela_verb_noun' with present tense verbs. The naming is uniform and predictable, with no mixing of conventions.

    Tool Count5/5

    With 12 tools, the count is well-suited for a knowledge management server. It provides a balanced set of read operations, search, and simple interactions without being overwhelming or too sparse.

    Completeness2/5

    The tool set is heavily read-only, covering notes, folders, groups, and users, plus like/unlike. However, it lacks essential write operations such as creating, updating, or deleting notes or groups, which limits its completeness for typical workflows.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers