mcp-kibela🗒️
模型上下文协议 (MCP) 服务器实现，使 AI 助手能够搜索和引用 Kibela 内容。此设置允许像 Claude 这样的 AI 模型安全地访问存储在 Kibela 中的信息。
特点🚀
mcp-kibela 服务器提供以下功能：
- 笔记搜索：按关键词搜索 Kibela 笔记
- 我的笔记：获取您的最新笔记
- 笔记内容：通过ID获取笔记内容和评论
- Note by Path ：按路径获取笔记内容
- 创建笔记：创建新笔记
- 更新笔记内容：通过笔记id更新笔记内容
先决条件📋
在开始之前，请确保您已：
- Node.js（v18 或更高版本）
- MCP 客户端（Claude Desktop、Cursor 等）
- Kibela 访问令牌（ 如何获取令牌）
- Git（如果从源代码构建）
安装🛠️
与游标一起使用
{
"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.laKIBELA_TOKEN ：您的 Kibela API 令牌（必需）
贡献
欢迎任何贡献！
发展
- 使用
npm run build:watch以监视模式构建项目。
- 使用
npx @modelcontextprotocol/inspector检查 MCP 服务器。
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js
许可证📄
麻省理工学院