Kibela MCP Server

Kibela MCP 服务

用于集成 Kibela API 的 MCP 服务实现，让大模型能够与 Kibela 内容交互。

提示

此扩展使用 graphql 包中的 buildClientSchema、getIntrospectionQuery 和 printSchema 函数执行 GraphQL 架构内省，以逆向分析 Kibela 的 API。详情请见此处

功能

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

配置

环境变量

• 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
  • limit（数字，可选）：要获取的笔记数量（默认值：100）
• 返回：笔记列表，包含作者信息，并按最后更新时间排序

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 扩展