Kibela MCP Server

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

功能

• 使用高级筛选器搜索笔记
• 获取您的最新笔记
• 获取笔记内容和评论
• 管理组和文件夹
• 点赞/取消点赞笔记
• 列出用户
• 查看笔记附件
• 查看最近查看的笔记
• 按路径获取笔记

配置

环境变量

• KIBELA_TEAM: 您的Kibela团队名称（必需）
• KIBELA_TOKEN: 您的Kibela API令牌（必需）

Cursor 集成

将以下内容添加到您的~/.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 (字符串数组, 可选): 按用户ID过滤
  • folderIds (字符串数组, 可选): 按文件夹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：

{
    "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 的 VS Code 扩展