オープンソース · MCP ネイティブ

AI エージェントのための ナレッジベース

hyseed はオープンソースのローカルナレッジベースです。チームの意思決定・教訓・API・ランブックを構造化された事実に変え、Claude Code、Cursor、Cline などの MCP クライアントから直接利用できます。データはローカルに留まります。

MIT オープンソース · Windows x64 · VS Code 1.101+

$ hyseed search "sqlite fts5 decision"

dec/use-sqlite-fts5decision · accepted
→ kb_get(..., section="Architecture")target section only
context70–90% less on long docs

セクション単位で取得し、文書全体をコンテキストに入れません。

既存ツールに足りないもの

人が書く方法、似た文章の探し方、会話の覚え方は解決しますが、「AI がチームのレビュー済み事実を確実に使う方法」は解決していません。

人間向けノート(Notion / Obsidian)

ページ中心で人には使いやすい。AI 接続はコネクタやプラグインに依存し、構造は人の運用に委ねられます。

ベクトルストア / RAG(Chroma / LanceDB など)

類似検索は得意だが、スキーマ・バージョン・チーム協業はなく、検索パイプラインを自作する必要があります。

AI メモリ(Mem0 / Zep など)

単一エージェントの会話メモリが中心で、自動抽出が主。チームレビューや長期ガバナンスには向きません。

hyseed が埋めるのは、チームがレビューした構造化事実を MCP 経由で AI が使えるようにする部分です。

AI に使われるために設計

Wiki にチャット欄を足すのではなく、検索・構造・バージョン・協業をプロトコルとデータモデルに組み込みます。

MCP ネイティブ

文書 CRUD、検索、グラフ、バージョン、スケジュールを MCP で公開。Claude Code、Cursor、Cline などから直接接続できます。軽量に使いたいときは、読み取り専用のシンモードに切り替えられます。

自由文ではなく型付きスキーマ

プロジェクト、意思決定、教訓、用語集、人物、FAQ、API、ランブック、リリースの 9 種類。型付きメタデータと安定 ID により、AI は事実を正確に抽出できます。

セクション単位の取得

kb_get は見出し単位で取得でき、セクションがない場合は目次を返します。長文のコンテキスト消費を 70–90% 削減できます。

バージョン・監査・ロールバック

変更ごとにバージョン番号を持ち、フィールド単位の差分、任意バージョンへの復元、論理削除からの復元、監査ログを備えます。AI の自動書き込みも安心です。

型付きナレッジグラフ

10 種類の標準リレーション、自動バックリンク、マルチホップ探索、影響分析、意思決定チェーン。意思決定を変えたとき、影響を受ける文書をたどれます。

Git ネイティブな協業

ナレッジは Git 上の Markdown として存在し、tags / aliases / links / metadata は 3-way マージ。PR レビュー、ブランチ、Code Owners をそのまま使えます。

並べて見る

設計の中心からデータ配置まで、4 つの形態の違いがひと目で分かります。

並べて見る
比較軸人間向けノート(Notion / Obsidian)ベクトルストア + RAGAI メモリhyseed
設計の中心人とページモデルとベクトル単一エージェントの会話AI エージェント + 人、同じ知識を共有
AI 接続Web / エディタ。コネクタやプラグイン経由SDK + 自前の検索パイプラインSDK / API、フレームワーク依存MCP ネイティブ + CLI + 管理コンソール + VS Code 拡張
データ構造自由形式、運用で規定ベクトルのみ、スキーマなし自動抽出されたメモリ項目9 種の文書タイプ + 型付きメタデータ + 安定 ID
検索キーワード / プラグインベクトル類似度が中心意味的な想起FTS5 BM25 / 曖昧 / セマンティック(sqlite-vec)/ RRF ハイブリッド
コンテキストコストページ全体チャンク返却、まだ削る必要メモリ注入、粒度は制御しにくいセクション単位。長文で 70–90% 削減
バージョンと監査ページ / ファイル履歴。監査はプランやプラグイン依存通常なし重点ではないバージョン、フィールド差分、復元、論理削除、監査
チーム協業Notion はリアルタイム。Obsidian は Git / 同期なし弱く、プラットフォーム内Git ネイティブ + 3-way マージ + PR レビュー
データと配備Notion はクラウド。Obsidian はローカルファイルローカル / クラウド、セルフマネージドセルフホストの OSS またはクラウド単一ファイルの SQLite、完全ローカル、クラウドなし、テレメトリーなし、MIT

3 ステップで既存ワークフローへ

拡張機能を入れるだけ。Python ランタイムの別途インストールは不要です。

拡張をインストール

VS Code Marketplace から hyseed をインストール。Windows x64 と VS Code 1.101+ に対応しています。

code --install-extension limccn.kbmcp-vscode

管理コンソールを開く

コマンドパレットで hyseed: Open admin console を実行すると、ブラウザでローカル管理コンソールが開きます。

知識を作成・変換・取り込み

文書を作成するか、既存文書を変換するか、Markdown を取り込みます。MCP クライアントから直接 AI に検索させることもできます。変更はすべてバージョン管理されます。

hyseed search "sqlite fts5"

Markdown、Word(.docx)、PowerPoint(.pptx)、Excel(.xlsx / .xlsm / .xls)、PDF、TXT、JSON、CSV に対応。初回利用時にローカル vault が作成されます。

すぐに使えて、ローカル完結

hyseed は MIT ライセンスのオープンソースで、現行バージョンは 0.1.1。単一ファイルの SQLite に保存し、クラウド不要、テレメトリーなし。VS Code 拡張を入れるだけで、チームの意思決定と教訓をいつでも検索・追跡できます。セマンティック検索は sqlite-vec 拡張で有効にできます。

バージョン

Marketplace 0.1.1

ライセンス

MIT · オープンソース

データ

ローカル SQLite · テレメトリーなし

対応環境

Windows x64 · VS Code 1.101+

ランタイム

拡張に同梱、Python 不要

検索

語彙 / あいまい / セマンティック / RRF ハイブリッド

チームの知識を AI ワークフローへ

VS Code Marketplace から hyseed をインストール。ローカルで追跡可能、協業できるオープンソースのナレッジベースを数分で用意できます。

MIT オープンソース · Windows x64 · ランタイムの別途インストール不要