Kibela

🚀 Kibela MCP 服務器

Kibela MCP 服務器是一個開源項目，遵循模型上下文協議（Model Context Protocol），致力於搭建 AI 工具與 Kibela 筆記服務之間的橋樑。藉助該服務器，AI 模型能借助 HTTP 協議對 Kibela 中的筆記數據進行訪問和操作。

✨ 主要特性

• 搜索筆記：支持通過關鍵詞或條件查詢筆記內容。
• 創建與更新筆記：允許 AI 工具生成、編輯和管理筆記。
• 評論交互：AI 可以添加和回覆筆記中的評論，增強互動性。
• 文件管理：支持附件上傳及關聯，提升筆記的擴展能力。
• 安全審計：確保所有操作符合安全規範，保障數據完整性。

🔧 技術細節

核心組件

工具定義

以下是 MCP 服務器中預設的關鍵工具及其功能描述：

• 搜索筆記
  • 功能：通過關鍵字或篩選條件查找特定筆記。
  • 輸入格式：支持自由文本輸入和結構化查詢參數。
  • 輸出格式：返回匹配筆記的基本信息及內容摘要。
• 創建新筆記
  • 功能：生成新的空白筆記，可指定標題、內容及所屬組別。
  • 輸入格式：包含標題、正文和組別標識的 JSON 對象。
  • 輸出格式：返回新建筆記的唯一標識符和鏈接地址。
• 更新現有筆記
  • 功能：對已存在的筆記進行內容修改或擴展。
  • 輸入格式：包括筆記 ID 和需要更新的內容片段。
  • 輸出格式：確認更新操作成功的狀態信息。
• 添加評論
  • 功能：在指定筆記下添加新的評論內容。
  • 輸入格式：包含評論文本和目標筆記 ID 的數據包。
  • 輸出格式：返回新評論的詳細信息及關聯筆記鏈接。

操作指南

1. 安裝依賴

docker compose run mcp pnpm install

2. 啟動服務

docker compose up

3. 配置環境變量
   • 設置 KIBELA_ORIGIN 為你的 Kibela 實例地址。
   • 配置 KIBELA_ACCESS_TOKEN 用於身份驗證。
4. 掛載配置文件（可選）

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

自定義配置

通過編寫自定義工具描述和提示文件，可以進一步擴展服務器功能。具體步驟如下：

1. 創建一個 JSON 文件，例如 custom-config.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 協議，允許自由使用、修改和分發。