MCP Kibela服务

@kj455/mcp-kibela

0 Stars 393 次浏览 kj455 更新于 2026-08-23

一种模型上下文协议服务器，使AI助手能够搜索和访问存储在Kibela中的信息，支持笔记的搜索、检索、创建和更新。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-kibela": {
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "command": "docker",
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

该服务需要配置环境变量：KIBELA_TEAM、KIBELA_TOKEN

可用工具（6 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

kibela_search_notes 1 个参数需填 1 项 Search Kibela notes by query

Search Kibela notes by query

必填参数：query

kibela_get_my_notes 1 个参数 Get my latest notes from Kibela

Get my latest notes from Kibela

该工具无需必填参数，直接调用即可

kibela_get_note_content 1 个参数需填 1 项 Get note content by note ID

Get note content by note ID

必填参数：id

kibela_get_note_from_path 1 个参数需填 1 项 Get note content by note path

Get note content by note path

必填参数：path

kibela_update_note_content 2 个参数需填 2 项 Update note content by note id. This tool allows you to modify the content of an existing Kibela note. Before updating, it fetches the current content of the note to ensure proper version control. Note that you need the note ID (not the note path) to use this tool.

Update note content by note id. This tool allows you to modify the content of an existing Kibela note. Before updating, it fetches the current content of the note to ensure proper version control. Note that you need the note ID (not the note path) to use this tool.

必填参数：id、content

kibela_create_note 7 个参数需填 2 项 Create a new note in Kibela.

Create a new note in Kibela.

必填参数：title、content

服务介绍

mcp-kibela 🗒️

这是一个实现了模型上下文协议（MCP）的服务器，它使AI助手能够搜索和引用Kibela中的内容。这种设置允许像Claude这样的AI模型安全地访问存储在Kibela中的信息。

功能 🚀

mcp-kibela 服务器提供了以下功能：

笔记搜索：通过关键词搜索Kibela笔记
我的笔记：获取您的最新笔记
笔记内容：通过ID获取笔记内容和评论
通过路径获取笔记：通过路径获取笔记内容
创建笔记：创建新笔记
更新笔记内容：通过笔记ID更新笔记内容

先决条件 📋

开始之前，请确保您具备：

Node.js (v18或更高版本)
MCP客户端 (例如 Claude Desktop, Cursor等)
Kibela访问令牌 (如何获取令牌)
Git (如果从源码构建)

安装 🛠️

使用Cursor

{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

使用VSCode

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

使用Claude Desktop

{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

使用Smithery

npx -y @smithery/cli install @kj455/mcp-kibela --client claude

环境变量

需要设置以下环境变量：

KIBELA_TEAM：您的Kibela团队名称（必需）。您可以从Kibela团队页面的URL中找到它。例如 https://[team-name].kibe.la
KIBELA_TOKEN：您的Kibela API令牌（必需）

贡献

欢迎任何形式的贡献！

开发

使用 npm run build:watch 在监视模式下构建项目。

npm run build:watch

使用 npx @modelcontextprotocol/inspector 检查MCP服务器。

npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

许可证 📄

MIT

查看源码项目主页

MCP 服务配置

可用工具 （6 个）