MCP Kibela Server

Kibela MCP服务器

  ](https://smithery.ai/server/@kiwamizamurai/mcp-kibela-server)

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

\[！提示\] 该扩展使用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 （string）：搜索查询 - coediting （布尔值，可选）：按共同编辑状态筛选 - isArchived （布尔值，可选）：按存档状态筛选 - sortBy （字符串，可选）：排序方式（相关，内容_更新_AT） - userIds （string\[\]，可选）：按用户ID筛选 - folderIds （string\[\]，可选）：按文件夹ID筛选

• 返回：包含ID、标题、URL、作者、组等的匹配笔记列表

kibela_get_my_notes

从Kibela获取您的最新笔记

• 输入：

- limit （数字，可选）：要提取的钞票数量（默认值：15）

• 返回：包含作者信息的最新笔记列表

kibela_get_note_内容

获取特定笔记的内容和评论

• 输入：

- id （string）：备注ID - include_image_data （布尔值，可选）：是否在响应中包含图像数据URL（默认值：false）

• 返回：完整的笔记内容，包括HTML、评论、附件、组、文件夹等

kibela_getgroups

获取可访问组列表

• 输入：无
• 返回：包含隐私设置和权限等详细信息的组列表

kibela_get_group_folders

获取组中的文件夹

• 输入：

- groupId （字符串）：组ID - parentFolderId （字符串，可选）：嵌套文件夹的父文件夹ID

• 返回：包含注释和元数据的文件夹列表

kibela_get_group_notes

获取未附加到任何文件夹的组中的笔记

• 输入：

- groupId （字符串）：组ID

• 返回：包含作者信息的笔记列表，按上次更新时间排序

kibela_get_folder_notes

在文件夹中获取笔记

• 输入：

- folderId （string）：文件夹ID - limit （数字，可选）：要提取的钞票数量（默认值：100）

• 返回：包含作者信息的笔记列表，按上次更新时间排序

kibela_get-users

获取用户列表

• 输入：无
• 返回：具有ID、帐户和真实姓名的用户列表

kibela_like_note

就像一张纸条

• 输入：

- noteId （string）：备注ID

• 返回：更新的赞列表

kibela_unlike_note

与便条不同

• 输入：

- noteId （string）：备注ID

• 返回：更新的赞列表

kibela_getrecenty_viewed_注释

获取您最近查看的笔记

• 输入：

- limit （数字，可选）：要提取的钞票数量（最多15张）

• 返回：包含作者信息的最近查看的笔记列表

kibela_get_from_path

按路径或URL获取笔记内容

• 输入：

- path （string）：注释路径（例如“/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 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扩展