Kibela MCP 服务器

MCP 服务器实现 Kibela API 集成，使 LLM 能够与 Kibela 内容进行交互。

特征

• 使用高级过滤器搜索笔记

• 获取最新笔记

• 获取笔记内容和评论

• 管理群组和文件夹

• 喜欢/不喜欢笔记

• 列出用户

• 查看笔记附件

• 查看最近查看过的笔记

• 按路径获取笔记

配置

环境变量

• KIBELA_TEAM ：您的 Kibela 团队名称（必填）

• KIBELA_TOKEN ：您的 Kibela API 令牌（必需）

光标集成

添加到您的~/.cursor/mcp.json ：

如果你想使用 docker

工具

kibela_search_notes

使用给定查询搜索 Kibela 笔记

• 输入：

  • query （字符串）：搜索查询

  • coediting （布尔值，可选）：按共同编辑状态过滤

  • isArchived （布尔值，可选）：按存档状态过滤

  • sortBy （字符串，可选）：按（RELEVANT、CONTENT_UPDATED_AT）排序

  • userIds (string[], 可选): 按用户 ID 过滤

  • folderIds (string[], 可选): 按文件夹 ID 过滤

• 返回：包含 ID、标题、URL、作者、群组等信息的匹配笔记列表

kibela_get_my_notes

从 Kibela 获取最新笔记

• 输入：

  • limit （数字，可选）：要获取的注释数量（默认值：15）

• 返回：包含作者信息的最新笔记列表

kibela_get_note_content

获取特定笔记的内容和评论

• 输入：

  • id （字符串）：笔记 ID

  • include_image_data （布尔值，可选）：是否在响应中包含图像数据 URL（默认值：false）

• 返回：完整的笔记内容，包括 HTML、评论、附件、组、文件夹等

kibela_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、账号、真实姓名的用户列表

kibela_like_note

就像一张纸条

• 输入：

  • noteId （字符串）：注释 ID

• 返回：更新的点赞者列表

kibela_unlike_note

与笔记不同

• 输入：

  • 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 ：

MCP检查员

并设置环境

Docker

在本地构建并运行：

然后使用这个配置：

对于 SSE 传输，确保服务器 URL 设置为： http://localhost:3000/sse

其他产品

• kibela 的 vscode 扩展