Kibela MCP 服务器

NPM 版本 NPM 下载

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

实现与 Kibela API 的集成以搜索和检索笔记，让 LLM 能够与 Kibela 内容无缝交互。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP JinaAI Search Server
spences10
A
security
A
license
A
quality
Enables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.
Last updated -
1
560
4
JavaScript
MIT License
Notion MCP Server
orbit-logistics
-
security
F
license
-
quality
Enables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.
Last updated -
10
20
TypeScript
Curri MCP Server
teamcurri
-
security
F
license
-
quality
Enables interaction with Curri's API by managing text notes, offering tools for note creation, and generating summaries using structured prompts.
Last updated -
JavaScript
MCP Kibela
kj455
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
Last updated -
6
559
12
TypeScript
MIT License

View all related MCP servers

Kibela MCP Server