Kibela MCP 服务器

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

特征

使用高级过滤器搜索笔记
获取最新笔记
获取笔记内容和评论
管理群组和文件夹
喜欢/不喜欢笔记
列出用户
查看笔记附件
查看最近查看过的笔记
按路径获取笔记

配置

环境变量

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_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、评论、附件、组、文件夹等

本地开发

从源运行

克隆存储库
安装依赖项： 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

在本地构建并运行：

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

其他产品

kibela 的 vscode 扩展

Kibela MCP Server