AI导哈

Kibela MCP服务器

Kibela MCP Server是一个为Kibela设计的Model Context Protocol (MCP)服务器，支持通过MCP客户端进行笔记和文件夹操作，适用于知识管理和协作写作场景。

  • by kibela
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 kibela/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

许可证

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

相关 MCP