mcp-キベラ🗒️

AIアシスタントがKibelaコンテンツを検索・参照できるようにする、モデルコンテキストプロトコル（MCP）サーバー実装。この設定により、ClaudeのようなAIモデルはKibelaに保存された情報に安全にアクセスできるようになります。

機能🚀

mcp-kibela サーバーは次の機能を提供します。

ノート検索: キーワードでKibelaノートを検索
マイノート: 最新のノートを取得する
ノートコンテンツ: IDでノートコンテンツとコメントを取得します
パスによるノート: パスごとにノートの内容を取得します
ノートを作成: 新しいノートを作成する
ノートの内容を更新: ノート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"
      }
    }
  }
}

鍛冶屋を使う

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

環境変数

次の環境変数が必要です。

KIBELA_TEAM : Kibelaチーム名（必須）。KibelaチームページのURLから確認できます。例：https://[チーム名].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

ライセンス📄

マサチューセッツ工科大学

MCP Kibela