HippoDid MCP Server

HippoDid MCP Server
AI エージェント向けの永続的でポータブルなメモリです。AI はセッションのたびにすべてを忘れてしまいます。HippoDid は記憶します。

---

HippoDid MCP Server

HippoDid 用の MCP（Model Context Protocol）サーバーです。Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Codex CLI、Cursor、および MCP 互換クライアントを、永続的な AI キャラクターメモリに接続します。

HippoDid とは？

HippoDid は、AI エージェント向けのクラウドメモリインフラストラクチャです。構造化されたメモリ（好み、決定、スキル、関係性）を検索可能なデータベースに保存し、セッション、ツール、AI プロバイダーをまたいで取得します。Claude Code でメモリを書き込み、ChatGPT で呼び出せます。Cursor から Gemini に切り替えても、エージェントのメモリは引き継がれます。

主な機能：

• クロスプラットフォームメモリ — 同じメモリに、任意の MCP クライアントまたは OAuth 経由の ChatGPT からアクセスできます
• 構造化抽出 — 生のテキストを自動的に解析し、重要度スコア付きのカテゴリ別ファクトに変換します
• 時間的減衰 — カテゴリごとにメモリが自然に薄れていきます（スキルは長期間維持され、イベントは14日で薄れます）
• キャラクターごとのスコープ設定 — エージェント／プロジェクトごとに独自のメモリ名前空間を持ちます
• BYOK AI — 抽出に独自の OpenAI、Anthropic、または Gemini のキーを使用できます

クイックスタート

1. API キーを取得する

hippodid.com で登録し、ダッシュボードから API キーを作成します。

2. JAR をダウンロードする

最新リリースを GitHub Releases からダウンロードします。

3. Claude Desktop を設定する

Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "hippodid": {
      "command": "java",
      "args": ["-jar", "/path/to/hippodid-mcp-server-1.1.0.jar"],
      "env": {
        "HIPPODID_API_KEY": "hd_key_your_key_here",
        "HIPPODID_CHARACTER_ID": "your-character-uuid"
      }
    }
  }
}

4. 使用を開始する

Claude に、内容の記憶、メモリの検索、ファイルの同期などを依頼します。

MCP ツール

ツール	説明
create_character	メモリを保存する新しいキャラクターを作成します
list_characters	自分がアクセスできるすべてのキャラクターを一覧表示します
add_memory	AUDN パイプライン（ルールベースの重要度判定＋重複排除）を通じてメモリを追加します
add_memory_direct	AUDN パイプラインを経由せず、メモリを直接書き込みます（Starter+ ティア）
search_memories	メモリ全体を対象に、セマンティック検索とキーワード検索を組み合わせて検索します
sync_file	ローカルファイルを HippoDid クラウドに同期します
import_document	ドキュメントをインポートしてメモリを抽出します（Starter+ ティア）
list_synced_files	キャラクターのクラウドに同期されたファイルを一覧表示します
get_sync_status	キャラクターの同期ステータスの概要を取得します
export_character	キャラクターのすべてのメモリを Markdown としてエクスポートします
add_watch_path	ファイルを同期し、バックグラウンド追跡用にパスを登録します
list_watch_paths	このセッションで監視中のすべてのファイルパスを一覧表示します
force_sync	監視中のすべてのパスを直ちに強制同期します
configure_ai	テナントの BYOK AI プロバイダーを設定します
test_ai_config	保存された AI プロバイダー設定の接続をテストします

環境変数

変数	必須	デフォルト	説明
HIPPODID_API_KEY	はい	—	HippoDid API キー
HIPPODID_CHARACTER_ID	いいえ	—	バックグラウンド同期に使用するデフォルトのキャラクター UUID
HIPPODID_BASE_URL	いいえ	https://api.hippodid.com	API のベース URL
MCP_SYNC_INTERVAL	いいえ	300	バックグラウンド同期の間隔（秒）
MCP_AUTO_CAPTURE	いいえ	false	バックグラウンド監視を無効化します（同期は AI が処理します）
MCP_AUTO_RECALL	いいえ	false	バックグラウンドでのデータ補完を無効化します（ダウンロードは AI が処理します）
MCP_RECALL_CACHE_TTL	いいえ	120	検索結果キャッシュの TTL（秒）

アーキテクチャ

Claude Desktop → stdio (JSON-RPC) → McpServerRunner → HippoDidClient → HTTP → HippoDid REST API

MCP サーバーは、hippodid-spring-boot-starter を使用して、HTTP 経由で HippoDid REST API と通信します。認証とテナント分離はすべて、Bearer トークンを使用してサーバー側で処理されます。

ソースからのビルド

Java 21 以降と Maven 3.8 以降が必要です。

mvn clean package -DskipTests
java -jar target/hippodid-mcp-server-1.1.0.jar

バージョニング

MCP サーバーのバージョンは、hippodid-spring-boot-starter のバージョンと一致します。互換性を保つには、両方を同じバージョンにする必要があります。

ライセンス

Apache License 2.0 — LICENSE を参照してください。