Kibela MCP Server

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写作

需求

1. 码头工人 已安装
2. Docker必须正在运行
3. Kibela 访问令牌 已发布
4. 实现以下功能的应用程序 MCP客户端 必须安装

安装

示例：克劳德桌面

将以下配置写入 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 install

docker compose up

MCP检验员测试

npx @modelcontextprotocol/inspector \
  -e KIBELA_ORIGIN=https://your-subdomain.kibe.la \
  -e KIBELA_ACCESS_TOKEN=*** \
  docker compose exec mcp bin/cli.mjs

许可证

此软件包根据以下条款获得许可 麻省理工学院 许可证。