Knownbase MCP Server

Model Context Protocol を介した、AI エージェント向けの永続的で検索可能なプロジェクトメモリ。

Knownbase はホスト型 MCP サーバーで、AI コーディングエージェント（Claude、Cursor、ChatGPT、Claude Code、Windsurf、その他の MCP 互換クライアント）に、git 履歴の外に置かれる永続的なメモ、決定事項、引き継ぎ情報を読み書きする場所を提供します。これは、セッションが終了した瞬間にエージェントが失ってしまう作業メモです。

このリポジトリは /mcp エンドポイントについて説明しています。接続方法、公開されるツール、認証の仕組みなどです。ローカルインストールは不要です。Knownbase はリモートのストリーミング HTTP MCP サーバーなので、クライアントを URL に向けるだけで接続できます。

https://knownbase.dev/mcp

これが解決する問題

AI エージェントはセッション間でステートレスです。新しいチャット、新しいターミナル、再起動した IDE ウィンドウは、すべてゼロから始まります。エージェントはコードを読み直しますが、物事がなぜそうなっているのかという理由の記憶はありません。

• アーキテクチャの決定とその背後にあるトレードオフ

• デバッグの経緯（「X を試したが、Y の理由でうまくいかなかった」）

• コード自体からは明らかでない規約や落とし穴

• セッション間、またはあなたとチームメイトのエージェント間でのタスクの引き継ぎ

• git 履歴を散らかしたくないが、エージェントには知っておいてほしいこと

メモリレイヤーがないと、毎セッション同じコンテキストを説明し直すか、エージェントが同じことを再発見（そして再び壊す）ことになります。Knownbase はエージェントに直接検索・書き込みができるワークスペースを提供するため、メモリはリセットされずに保持・蓄積されていきます。

Related MCP server: Librarian

クイックスタート

1. knownbase.dev で無料ワークスペースを作成します（カード登録は不要）。

2. MCP クライアントを https://knownbase.dev/mcp に接続します。クライアントごとの正確な手順は docs/CONNECTING_CLIENTS.md を参照してください（Claude、Claude Code、ChatGPT、Cursor、汎用 MCP クライアント）。

3. 静的 API キーまたは OAuth 2.1 のいずれかで認証します（ほとんどのクライアントは OAuth を自動検出します）。docs/AUTHENTICATION.md を参照してください。

4. get_context でタスクを開始して既知の情報を読み込み、remember で永続的な知識を書き込み、search_notes / get_note / upsert_note で直接制御することもできます。完全なツールリファレンス: docs/TOOLS.md

公開されるツール

ノートには、オプションの型付き・時間的メタデータ（decision / fact / constraint / … に加え、current / superseded / disputed のライフサイクル）を付与でき、get_context はこれらをランク付けやフィルタリングに使用します。ツールリファレンスの 型付き・時間的メモリ を参照してください。

エージェントのトークンを節約するために設計された、デフォルトで最小限のレスポンス形式を含む、パラメータレベルの完全なリファレンスは docs/TOOLS.md にあります。

リモートのホスト型 MCP サーバーである理由

すべてのノートはお客様自身のワークスペースにスコープされ、テナント間で共有されるものはありません。全文検索（対応プランではセマンティック/意味ベースの検索）はサーバー側で実行されるため、エージェントはノートのコーパス全体をコンテキストに読み込むことなく結果を得られます。ノートはバージョン管理され（編集のたびにリビジョンがスナップショットされます）、論理削除される（完全に消えるのではなくゴミ箱に入る）ため、エージェントの書き込みが取り返しのつかないものになることはありません。

リンク

• ホームページ: Knownbase の概要と対象者

• 機能

• 料金: 無料プラン（プロジェクト 3 件、ノート 300 件、MCP キー 2 個）に加え、Go / Solo / Team / Business プランがあり、各プランに 7 日間の無料トライアルが付属

• ブログ: MCP、エージェントメモリ、引き継ぎに関するガイド

• llms.txt: 機械可読な製品/エンドポイントの概要

• お問い合わせ · hello@knownbase.dev

リポジトリの内容

• docs/AUTHENTICATION.md: API キー、OAuth 2.1 フロー、プロジェクトスコープのキー

• docs/CONNECTING_CLIENTS.md: クライアントごとのセットアップ（Claude、Claude Code、ChatGPT、Cursor など）

• docs/TOOLS.md: 入出力形式を含む完全なツールリファレンス

• server.json: MCP Registry のマニフェスト

このリポジトリはホスト型サービスのドキュメントであり、Knownbase サーバーのソースコードは含まれていません。このドキュメントに問題がある場合、または実際のサーバーの動作と相違がある場合は、issue を開く か、hello@knownbase.dev までメールでお知らせください。

ライセンス

このリポジトリのドキュメントは MIT ライセンス の下で提供されます。Knownbase サービス自体の利用は、利用規約 に準拠します。