Kibela

🚀 Kibela MCP サーバー

Kibela MCP サーバーは、モデルコンテキストプロトコル (Model Context Protocol) に準拠したオープンソースプロジェクトです。このサーバーは、AI ツールと Kibela ノートサービスを接続することを目的としています。AI モデルは、このサーバーを通じて HTTP プロトコルで Kibela 内のノートデータにアクセスし、操作することができます。

✨ 主な機能

• ノート検索：キーワードや条件を使ってノート内容を検索できます。
• ノートの作成と更新：AI ツールがノートの生成、編集、管理を行えます。
• コメントのやり取り：AI がノートのコメントを追加し、返信することで、インタラクティブ性を高めます。
• ファイル管理：添付ファイルのアップロードと関連付けをサポートし、ノートの拡張性を向上させます。
• セキュリティ監査：すべての操作がセキュリティ規範に準拠し、データの完全性を保証します。

🔧 技術詳細

ツール定義

以下は、MCP サーバーに事前設定された重要なツールとその機能の説明です。

ノート検索

• 機能：キーワードまたはフィルタ条件を使用して特定のノートを検索します。
• 入力形式：自由テキスト入力と構造化されたクエリパラメータをサポートします。
• 出力形式：一致するノートの基本情報と内容の要約を返します。

新しいノートの作成

• 機能：新しい空白ノートを生成し、タイトル、内容、所属グループを指定できます。
• 入力形式：タイトル、本文、グループ識別子を含む JSON オブジェクト。
• 出力形式：新しく作成されたノートの一意の識別子とリンクアドレスを返します。

既存のノートの更新

• 機能：既存のノートの内容を修正または拡張します。
• 入力形式：ノート ID と更新する内容の断片を含みます。
• 出力形式：更新操作が成功したことを確認するステータス情報を返します。

コメントの追加

• 機能：指定されたノートに新しいコメントを追加します。
• 入力形式：コメントテキストと対象ノート ID を含むデータパケット。
• 出力形式：新しいコメントの詳細情報と関連するノートのリンクを返します。

操作ガイド

📦 インストール

docker compose run mcp pnpm install

サービスの起動

docker compose up

環境変数の設定

• KIBELA_ORIGIN をあなたの Kibela インスタンスのアドレスに設定します。
• KIBELA_ACCESS_TOKEN を認証に使用するように設定します。

設定ファイルのマウント（オプション）

docker compose exec mcp bin/cli.mjs \
  --config=/path/to/your/config.json

カスタム設定

カスタムツールの説明とプロンプトファイルを作成することで、サーバーの機能をさらに拡張できます。具体的な手順は次のとおりです。

1. custom-config.json などの JSON ファイルを作成します。

{
  "tools": {
    "search_kibela_note": {
      "description": "キーワードでノート内容を検索します。"
    }
  },
  "prompts": {
    "review": {
      "prompt": "指定されたリンクのノート内容を分析して要約し、改善提案を行います。"
    }
  }
}

2. この設定ファイルを Docker コンテナにマウントします。

docker run -v /path/to/custom-config.json:/config.json kibela-mcp-server

テスト検証

MCP Inspector ツールを使用してサーバーの機能をテストします。

npx mcp-inspector \
  --origin http://localhost:3000 \
  --token your-access-token

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されており、自由な使用、修正、配布が許可されています。