Kibela MCP サーバー
Kibela API 統合のための MCP サーバー実装。LLM が Kibela コンテンツと対話できるようにします。
特徴
高度なフィルターでノートを検索
最新のノートを入手する
メモの内容とコメントを取得する
グループとフォルダを管理する
いいね/いいね取り消しメモ
ユーザーをリストする
メモの添付ファイルを表示する
最近閲覧したメモを表示する
パスでメモを取得
Related MCP server: Notion 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(文字列): ノートIDinclude_image_data(ブール値、オプション): レスポンスに画像データの URL を含めるかどうか (デフォルト: false)
返されるもの: HTML、コメント、添付ファイル、グループ、フォルダなどを含む完全なメモの内容
キベラ_get_groups
アクセス可能なグループのリストを取得する
入力: なし
戻り値: プライバシー設定や権限などの詳細を含むグループのリスト
kibela_get_group_folders
グループ内のフォルダを取得する
入力：
groupId(文字列): グループIDparentFolderId(文字列、オプション): ネストされたフォルダの親フォルダ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、コメント、添付ファイル、グループ、フォルダなどを含む完全なメモの内容
地域開発
ソースから実行
リポジトリをクローンする
依存関係をインストール:
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に設定されていることを確認します。