MCP基贝拉服务器

Name: MCP基贝拉服务器
Author: kiwamizamurai

作者：kiwamizamurai7 星标更新：2025-08-23

安装使用来源：spider==github.com

项目介绍

Kibela MCP Server

NPM 下载量

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

[!TIP] 此扩展通过使用来自 graphql 包的 buildClientSchema、getIntrospectionQuery 和 printSchema 函数执行 GraphQL 模式内省，以逆向工程 Kibela 的 API。详情见此

功能

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

配置

环境变量

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 (字符串数组，可选)：按用户 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、评论、附件、组、文件夹等

本地开发

从源码运行

克隆仓库
安装依赖：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 扩展