kb-mcp

# kb 複数プロジェクト × 複数AIの共通コンテキスト基盤。ローカルMCPサーバーとして動作する。 kb は単なるノート置き場ではなく、AI がセッションをまたいで成長するための共有学習基盤を目指している。 Claude、Copilot、Codex のような複数の AI が、`gap`、`knowledge`、`adr` を通じて「ユーザーが AI に求めること」と「そのプロジェクトで積み上がった判断や知見」を学び、次のやり取りで自然に活かせる状態を作る。 目標は 2 つある。 - 単体 AI が、過去の失敗や判断を踏まえて継続的に賢くなること - AI チーム全体が、同じユーザー・同じプロジェクト文脈を共有しながら揃って成長していくこと ## 技術スタック - Python + uv - MCP SDK（公式Python版） - Obsidian CLI 1.12+ - git ## Installation ### Prerequisites - [uv](https://docs.astral.sh/uv/) - [Obsidian](https://obsidian.md/) 1.12+ (CLI 有効化: Settings > General > Advanced > Command Line Interface) ### 1. Install ```bash uv tool install kb-mcp ``` ### 2. Setup ```bash kb-mcp setup ``` 対話形式で以下を設定: - Obsidian Vault のパス（新規作成 or 既存 Vault に統合） - タイムゾーン 設定は `~/.config/kb/config.yml` に保存される。 ### 3. MCP サーバー登録 使用する AI ツールに合わせて登録する。複数ツールから同じ `kb-mcp` を共有できる。 #### Claude Code ```bash claude mcp add kb --scope user -- kb-mcp serve ``` #### Codex CLI `~/.codex/config.toml`（`CODEX_HOME` 設定時はそちら）に追加: ```toml [mcp_servers.kb] command = "kb-mcp" args = ["serve"] ``` #### GitHub Copilot CLI `~/.copilot/mcp-config.json`（`COPILOT_HOME` 設定時はそちら）を作成（または追記）: ```json { "mcpServers": { "kb": { "command": "kb-mcp", "args": ["serve"] } } } ``` ### 4. Hooks インストール（オプション） ```bash kb-mcp install hooks --all # 全ツールの hook snippet / wrapper を用意 kb-mcp install hooks --claude --execute # 可能なものは設定ファイルまで反映 ``` ### 5. 動作確認 ```bash kb-mcp doctor ``` ## データ配置 ノートはこのリポジトリには含まれない。`kb-mcp setup` で設定した Obsidian Vault に保存される。 ``` <vault_path>/<kb_root>/ projects/<project-name>/ adr/ # 意思決定ログ gap/ # AI指摘 → 本当はどうしてほしかったか session-log/ # セッションログ knowledge/ # 開発中に得た知識 draft/ # やりたいこと・アイデアメモ inbox/ # プロジェクトに紐づかないアイデア general/ knowledge/ # プロジェクト横断の共通知見 requirements/ # ユーザーがAIに求めることの集約 ``` ## MCP Tools | tool | 役割 | |---|---| | `kb_init` | プロジェクト初期化 | | `kb_adr` | 意思決定ログ保存 | | `kb_g…