mcpField
Q
Quipu

Quipu

ローカル
scbrown.github.ioメモリ・ナレッジ8今日更新
リポジトリ公式サイト

Quipu について

Quipuは、AIエージェントと運用者向けのローカルな二時点ナレッジグラフストアです。CLI、REST、MCP、Rustアプリケーションから利用でき、語彙や形状に基づいて書き込みを検証し、出典と履歴を保持します。

主な機能

  1. 01語彙と形状による知識の検証
  2. 02事実と決定の二時点履歴
  3. 03事実の出典記録
  4. 04SPARQLによる現在・過去の知識検索
  5. 05検証済み知識バンドルのインポート

活用シーン

  1. 01複数のエージェントやツール間でプロジェクト情報を共有
  2. 02特定時点で成立していた事実の検索
  3. 03デプロイイベントを統制された記憶に追加

MCP 対応

指定したデータベースに接続するローカルMCPサーバーとして動作し、知識をクライアントに公開します。HTTP MCPにも対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "scbrown-quipu": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/scbrown/quipu:0.15.0"
      ]
    }
  }
}
起動コマンドdocker run -i --rm ghcr.io/scbrown/quipu:0.15.0

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocighcr.io/scbrown/quipu:0.15.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Quipu：結び目で記録された知識と歴史。Thread Workshopのスタック用イラストシリーズ

Quipuのロゴ：結び目のあるひもで表したナレッジグラフ

Quipu

エージェントが読み取り、再利用し、共有できる、ガバナンスの効いた知識

Apache-2.0 · CI · ドキュメントを読む

Quipuは、AIエージェントとその運用者のための、ガバナンスの効いた二時点知識ストアです。 コマンドライン、REST、MCP、またはRustアプリケーションから利用できます。 quipuはアンデス地方の結び目のある紐による記録で、紐がエンティティ、結び目が事実を表します。

Quipuを使う理由

  • ガバナンス： 受け取った知識を語彙や形状に照らして検証します。
  • 二時点管理： 事実や判断の履歴を、クエリ可能な形で保持します。
  • 再利用可能なエージェント知識： エージェントがツール間で読み取り、再利用し、共有できるメモリを保存します。
  • 時間を認識するエンティティ： Chaskiが反応できるよう、イベントを発生させる時間属性を付与します。

Quipuはさまざまなツールの中核となるグラフおよび基盤として利用できます。スタックをご覧ください。 詳細な背景はQuipuを選ぶ理由をご覧ください。

アニメーション：1つのQuipuストアがCLI、MCPクライアント、HTTPサーバー、Rustライブラリ、オフライン利用、WebAssemblyに接続します

インストール

curl -fsSL https://raw.githubusercontent.com/intigraph/quipu/main/install.sh | sh

LinuxおよびmacOSに対応し、x86_64とarm64をサポートしています。Python 3.9以降とcurlが必要です。 インストーラーは公開アーカイブのチェックサムと実行ファイルのバージョンを検証します。 次に、quipu --versionを実行してください。Quipuのインストール、アップグレード、削除。 スタック全体を利用する場合は、Tamboのガイド付きオンボーディングをご利用ください。

3つのコマンドで最初の成功を

空のディレクトリで公開フィクスチャを取得し、そのエピソードを保存して、関係を尋ねます。

curl -fsSL https://raw.githubusercontent.com/intigraph/quipu/main/docs/demos/terminal/fixture/episode.json -o episode.json
quipu episode episode.json --base-ns urn:demo: --timestamp 2026-01-01T00:00:00Z --db demo.db
quipu read 'SELECT ?person ?thing WHERE { ?person <urn:demo:studies> ?thing }' --db demo.db

クエリはAda → Engineを返します。実際のローカルエピソードとクエリをご覧ください。

アニメーション端末：公開メモがクエリ可能なQuipuグラフになります

結果の行を、ひもと結び目で描画したものです。

生成されたグラフ：AdaがEngineを研究しており、各ひもが1つのエンティティ、関係がそれらを結んでいます

この記録では、サーバーやモデルを使わず、ローカルの公開フィクスチャを使用しています。ネイティブの警告もそのまま残しています。事実を読み込んでも、セマンティックインデックスの準備ができた証明にはなりません。 トランスクリプト、ツールのバージョン、再現可能なキャプチャ。

独自のコードで使う

同じコンテキストを各エージェントに貼り付けるのではなく、プロジェクトの事実、判断、関係をまとめて管理します。

目的こちらから
事実を読み込み、語彙を適用するクイックスタート
現在または過去の知識について尋ねるSPARQLと時間
ガバナンスの効いた知識バンドルを共有する検証済み共有
ドメイン知識と形状を準備するCamayoc

アニメーション：共有データをエクスポートし、隔離環境で検証してから、受け入れた知識を明示的に昇格します。競合は暗黙にマージされません

### リポジトリのナレッジ

リポジトリペンダントの構成：依存関係とアラインメント

最新リリースには、リポジトリペンダント、チェックサム、来歴情報が含まれています。これらをまとめて検証してから、quipu import SHARE_DIR --db repository.dbを使用してください。インポートではナレッジがステージングされ、ROOTは変更されません。検証済みインポートワークフローに従ってください。

デリバリーイベント

デプロイの結果と変更履歴を、同じ統制されたメモリに取り込みます。 これらのアダプターは、CloudEvents 上の CDEvents と Camayoc の単一の受信口を使用します。

カタログデータ · 表の更新

ツール標準方法ステータスドキュメント
GitHub / Forgejo ActionsCloudEvents 上の CDEvents再利用可能なデプロイイベントアクションまたは CLI。スキップまたはキャンセルされたジョブはデプロイイベントを出力しません。対応アダプター。有効化は別途必要ですガイド
AnsibleCloudEvents 上の CDEventsコールバックは適用されたホストごとにイベントを1件書き込みます。サマリーの失敗または到達不能のカウンターは、失敗を意味します。対応アダプター。有効化は別途必要ですガイド
TerraformCloudEvents 上の CDEvents実際の apply -json をラップします。変更を試みた後にエラーが発生するか、終了コードがゼロ以外の場合は、失敗を意味します。対応アダプター。有効化は別途必要ですガイド
ネイティブ CDEventsCloudEvents 上の CDEvents対応する CDEvents を単一の統制された受信口に渡します。不明なタイプは隔離されます。対応アダプター。有効化は別途必要ですガイド
GitHub の変更ライフサイクルCloudEvents 上の CDEvents変更、CI、ネイティブレビューの記録を読み取り、ChangeEvent の履歴に取り込みます。スケジューリングは別途必要です。対応アダプター。有効化は別途必要ですガイド

カタログが示すのはソースへの対応状況であり、インストール済みのプロデューサーや測定済みのイベント網羅率ではありません。 デプロイ頻度、変更失敗率、リードタイム、復旧時間をグラフでクエリするには、選択したサービス、リポジトリ、時間枠に対する記録済みイベントが必要です。 変更またはデプロイの履歴がない場合、それは測定値がゼロという意味ではありません。

エージェントに接続する

Claude Code の場合は、ローカルの MCP サーバーをデータベースに接続します。

claude mcp add quipu -- quipu mcp --db /path/to/knowledge.db

MCP Registry の識別子は mcp-name: io.github.intigraph/quipu です。 その他のクライアント、HTTP MCP、認証情報の設定については、エージェントのセットアップを参照してください。 Tamboを使用して、ツールをまとめて設定し、検証してください。

はじめる前に

  • CLI はローカルで実行されます。quipu-server はネットワーク API とエクスプローラーを提供します。
  • データベースと認証情報は非公開にしてください。デモ用フィクスチャはデプロイ用プロファイルではありません。
  • セマンティック検索には、設定済みのモデルとインデックスが必要です。グラフを保存するだけでは、どちらも用意されません。
  • 設定では、ストレージとサーバーの設定について説明しています。

次に読むもの

🧺 スタック

Tambo はこれらをまとめてインストールし、それぞれが動作することを確認します。各ツールは単独でも使用できます。 各ツールのインストール方法と最初の動作確認については、それぞれの README をご覧ください。

Quipu スタックは、ガバナンスされたバイテンポラルナレッジストアを中心に構築されています。これは、エージェントが照会できる共有の事実、決定事項、作業履歴を格納します。Quipu は、書き込み内容がルールに準拠しているかを確認し、各事実の出所を記録し、ある時点で何が真実だったかに回答できます。

ツールエージェントに提供するもの
tambo🧰 エージェントプラットフォームツールキット — quipu スタックをインストールして設定します
quipu出所と履歴を記録しながら共有の事実を保存し、書き込み内容がルールに準拠しているかを確認できます
camayocQuipu 用のナレッジと語彙を準備し、登録前に確認します
quechua相互運用可能なナレッジのための共有語彙と構造
chaskiグラフの変更に反応し、ガバナンスされた通知を配信します
bobbinコードベースをインデックス化し、そのインデックスと Quipu のナレッジからコンテキストを挿入します
yupanaコードへの影響を表示し、Quipu からポリシーを読み取ってエージェントのアクションを制御できます
desire-pathエージェントのミスを機能リクエストに変換します。Quipu なしでも単独で動作します
seedsQuipu ナレッジベースを基盤とする作業項目トラッカー
shantytown手動、スケジュール、またはイベントをトリガーとして、作業項目に取り組む AI エージェントのチームを実行します。Quipu を通じて作業とメモリを共有できます
rikuyQuipu 上でステータス、グラフ、監視対象、署名付き決定事項を確認できるライブブリーフ
shuttle署名付きエージェントワークフローを実行し、その記録を Quipu に保存します

貢献

CONTRIBUTING.mdをご覧ください。リポジトリでは次のチェックを実施します。

just check
just docs check

📜 ライセンス

Apache-2.0。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。