Kibela MCP Server
Kibela MCP Server is a Model Context Protocol (MCP) server for Kibela.
概述
Kibela MCP Server目前仅作为使用STDIO的本地服务器可用，并且可以与任何MCP客户端（如Claude Desktop或VSCode）一起使用。
只有那些公开可用且适用于MCP的GraphQL API才被实现为工具。
用例
- 询问Kibela的信息
- 在Kibela中组织文件夹和文章
- 使用AI帮助你用Kibela写作
需求
安装
示例：克劳德桌面
将以下配置写入 claude_desktop_config.json.将Kibela源和访问令牌设置为环境变量。
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"-e",
"KIBELA_ORIGIN",
"-e",
"KIBELA_ACCESS_TOKEN",
"ghcr.io/kibela/kibela-mcp-server"
],
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}没有Docker
然后将脚本设置为执行命令。此时，请确保脚本的路径是绝对的。
{
"mcpServers": {
"kibela": {
"command": "/path/to/kibela-mcp-server/bin/cli.mjs",
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}可用工具
注释操作
search_kibela_note-搜索笔记
- query：搜索关键字（必填） - resources：资源类型筛选器（可选） - coediting：共同编辑标志（可选） - updated：更新日期范围（可选） - groupIds：组ID筛选器（可选） - folderIds：文件夹ID筛选器（可选） - likerIds：Liker用户ID过滤器（可选） - isArchived：存档标志（可选） - sortBy：排序顺序（可选）
get_kibela_note_by_relay_id-通过中继ID获取注释
- id：备注的中继ID（必填）
get_kibela_note_from_path_or_url-从路径或URL获取注释
- path：笔记的路径或URL（必填）
get_kibela_notes-在文件夹中获取笔记
- folderId：文件夹ID（必填） - first：前面的记录数（可选） - last：从后面开始的记录数（可选）
create_kibela_note-创建新笔记
- title：注释标题（必填） - content：备注内容（必填） - draft：草稿标志（可选） - groupIds：所属组ID列表（必填） - folders：文件夹信息（可选） - groupId：组ID - folderName：文件夹名称
update_kibela_note_content-更新笔记内容
- id：备注ID（必填） - newContent：新内容（必填） - baseContent：原始内容（必填）
文件夹操作
search_kibela_folder-搜索文件夹
- query：搜索关键字（必填）
get_kibela_folder_by_relay_id-按中继ID获取文件夹
- id：文件夹的中继ID（必需） - first：前面的记录数（可选）
get_kibela_folder_from_path_or_url-从路径或URL获取文件夹
- path：文件夹的路径或URL（必填） - first：前面的记录数（可选）
get_kibela_folders-获取文件夹列表
- first：前面的记录数（可选） - last：从后面开始的记录数（可选）
create_kibela_folder-创建新文件夹
- groupId：组ID（必填） - fullName：文件夹的完整路径名（必需）
move_kibela_note_to_another_folder-将笔记移动到另一个文件夹
- id：备注ID（必填） - fromFolder：源文件夹信息（必需） - groupId：组ID - folderName：文件夹名称 - toFolder：目标文件夹信息（必需） - groupId：组ID - folderName：文件夹名称
attach_kibela_note_to_folder-将笔记与文件夹关联
- id：备注ID（必填） - folder：文件夹信息（必填） - groupId：组ID - folderName：文件夹名称
评论操作
create_kibela_comment-在笔记上创建评论
- content：评论内容（必填） - noteId：目标钞票ID（必填）
create_kibela_comment_reply-创建对评论的回复
- content：回复内容（必填） - commentId：目标评论ID（必填）
其他操作
get_kibela_groups-获取组列表
- first：前面的记录数（可选） - last：从后面开始的记录数（可选）
get_kibela_feed_sections-获取订阅源部分列表
- kind：进料类型（必填） - groupId：组ID（必填）
可用提示
审核提示
将URL作为输入并查看指定的注释。
输入架构：
{
url: string; // URL format
}搜索提示
将查询作为输入并搜索相关信息。
输入架构：
{
query: string;
}相关注释提示
将URL作为输入并浏览相关注释。
输入架构：
{
url: string; // URL format
}反映评论提示
将URL作为输入，并反映其注释以供注意。
输入架构：
{
url: string; // URL format
}定制
您可以通过准备以下格式的JSON文件来定制工具描述和提示。
看 server.ts 用于工具和提示键。
{
"tools": {
"search_kibela_note": {
"description": "New description"
}
},
"prompts": {
"review": {
"prompt": "New review prompt"
}
}
}然后将其安装到容器上，如下所示：
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"-e",
"KIBELA_ORIGIN",
"-e",
"KIBELA_ACCESS_TOKEN",
"-v",
"/path/to/kibela-mcp-server-config.json:/usr/src/app/kibela-mcp-server-config.json",
"ghcr.io/kibela/kibela-mcp-server"
],
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}发展
docker compose run mcp pnpm installdocker compose upMCP检验员测试
npx @modelcontextprotocol/inspector \
-e KIBELA_ORIGIN=https://your-subdomain.kibe.la \
-e KIBELA_ACCESS_TOKEN=*** \
docker compose exec mcp bin/cli.mjs许可证
此软件包根据以下条款获得许可 麻省理工学院 许可证。
