Eve MCPクライアント

eve-clientは、サポートされているAIツールをホスト型のEveメモリサービスに接続するためのローカルインストーラーおよび統合CLIです。

ローカルツールを検出し、MCPを設定し、サポートされている場所にEve管理下のプロンプトファイルやフックファイルをインストールし、認証を管理します。また、統合の検証、修復、削除も可能です。サポートされているクライアントからローカル履歴をインポートすることもできます。

Eveの仕組み

eve installを実行すると、Eveは自動的に実行される4つのライフサイクルフックを設定します。セッション中にコマンドを入力する必要はありません。

ライフサイクルフックはClaude CodeおよびGemini CLIで利用可能です。Eveはプロンプトシードを使用してCodex CLIやその他のMCP互換クライアントにも接続するため、すべてのツールでメモリを共有できます。

Related MCP server: Sovereign Universal Memory MCP

クイックスタート — 5分

1. Eveワークスペースを取得する

evemem.comでアクセスをリクエストしてください。プロビジョニング後、サインインしてevemem.com/app/overviewでAPIキーを作成します。

2. クライアントをインストールする

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

uvがない場合:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

検証: eve version

3. Claude Codeを接続する (Gemini CLIの場合は --tool gemini-cli に置き換えてください)

eve connect --tool claude-code --api-key <your-eve-api-key>

これにより、認証、インストール、検証が統合されます。ステップバイステップの手順については、以下のAPIキーフローを参照してください。

期待される出力:

✓ MCP config written
✓ CLAUDE.md companion updated
✓ Lifecycle hooks configured — Eve auto-injects memory context on every session
✓ Eve memory is connected and responding

何が起きたのか？ Eveは4つのライフサイクルフックをインストールしました。これ以降、すべてのClaude Codeセッションはメモリコンテキストがプリロードされた状態で開始され、終了時には新しい学習内容がキャプチャされます。ClaudeにEveを使うよう指示する必要はありません。

eve connectが失敗した場合: eve doctor --tool claude-codeを実行し、診断出力を確認してください。github.com/sherifkozman/eve-mcpで問題を報告してください。

4. セッション間でのメモリをテストする

Claude Codeで、Claudeに次のように伝えます:

"私がPostgreSQLを使っていて、usersテーブルにはemailとcreated_atカラムがあることを覚えておいて。"

新しいClaude Codeセッションを開始し、次のように尋ねます:

"私が言及したデータベース構成は何だった？"

ClaudeはEveを通じてそれを思い出します。✓

手動のMCP設定スニペット（インストーラー不要）については、examples/を参照してください。

インストール

クライアントをインストールする前に、Eveワークスペースを取得してください:

• アクセスをリクエスト: https://evemem.com

• ワークスペースがプロビジョニングされたら、Eveダッシュボードにサインインします:

  • https://evemem.com/app/overview

• APIキー認証を使用する予定の場合は、クライアントを接続する前に、Eveの管理者/ユーザー設定フローからテナントキーを作成またはローテーションしてください。

GitHubから今すぐインストール

推奨:

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

代替案:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

またはスタンドアロンのbashインストーラー経由:

curl -fsSL https://raw.githubusercontent.com/sherifkozman/eve-mcp/main/install.sh | bash

その後、確認します:

eve version
eve --help

手動設定（インストーラーなし）

Claude Code、Gemini CLI、Codex CLI用のすぐに使えるMCP設定スニペットについては、examples/を参照してください。

PyPIからインストール（後日）

公開後、パッケージのインストールは以下のようになります:

uv tool install eve-client

または:

pipx install eve-client

Eveクライアントの機能

• サポートされているローカルAIクライアントの検出

• ファイル変更前のインストール計画の表示

• Eve管理下のMCP設定の書き込み

• サポートされている場所へのプロンプト/コンパニオンファイルのインストール

• すべてのセッションでメモリコンテキストを自動注入する4つのライフサイクルフックのインストール（SessionStart, UserPromptSubmit, PreCompact, Stop）

• ファイルベースの認証情報ストレージを使用したローカルでの認証管理

• 直接的なメモリアクセスのための eve memory search および eve memory status コマンドの提供

• Eve管理下の変更の検証、修復、ロールバック、アンインストール

• サポートされているクライアントからEveへのローカル会話履歴のインポート

ローカル履歴のインポート

現在サポートされているインポーターソース:

• Claude Code

• Codex CLI

• Gemini CLI

主要コマンド:

eve import scan --source claude-code
eve import preview --source claude-code --path <session_file>
eve import jobs                              # list scan jobs
eve auth login --tool claude-code
eve import upload --job <scan_job_id> --use-auth-from claude-code
eve import runs                              # list upload runs
eve import resume --run <run_id>
eve import cleanup --days 30
eve import cleanup --days 30 --apply

仕組み:

• マシン上のローカル履歴を解析します

• 正規化されたバッチを管理されたEveサービスにアップロードします

• スキャンジョブ、アップロード実行、リプレイ、再開のためにローカルのSQLite台帳を保持します

• デフォルトで、完了した古いローカルインポーター実行のドライランによるクリーンアップをサポートします

インポーターのメンテナンス:

• eve import cleanup は汎用的なローカル台帳メンテナンスコマンドであり、クライアント固有のインポートソース機能ではありません

認証に関する注意:

• 可能であれば、コマンドラインで直接シークレットを渡すことは避けてください

• 最初に eve auth login ... を実行し、その後APIキーを繰り返さずにインポーターコマンドを実行することを推奨します

• インタラクティブシェルでは、 eve auth login --tool claude-code が安全にキーの入力を求めます

現在のロールアウトに関する注意:

• 正確性と再開機能は安定しています

• 非常に大規模なインポート、特にClaudeを多用するインポートは、バッチ処理のデフォルト設定が調整される間、理想よりも遅くなる可能性があります

サポートされているクライアント

Claude Code

現在サポートされている機能:

• MCP設定

• CLAUDE.md コンパニオンファイル

• パッケージ管理されたフック

• インポーターサポート: scan, preview, upload, resume

現在の主な認証パス:

• Eve APIキー

Gemini CLI

現在サポートされている機能:

• MCP設定

• GEMINI.md コンパニオンファイル

• パッケージ管理されたフック

• インポーターサポート: scan, preview, upload, resume

現在の主な認証パス:

• Eve APIキー

Codex CLI

現在サポートされている機能:

• MCP設定

• Eve所有のOAuthログイン

• ランタイムベアラートークンの注入

• インポーターサポート: scan, preview, upload, resume

現在の主な認証パス:

• Eve OAuth

重要:

• ネイティブのCodex MCPログインは、サポートされているEveのパスではありません

Claude Desktop

ホスト型Eve向けにローカルで自動設定されることはありません。

認証要件

Eveワークスペースと、以下のいずれかが必要です:

• Eve APIキー、または

• サポートされているフローのためのEve OAuthアクセス

現在の認証の期待値:

• Claude Code: APIキー

• Gemini CLI: APIキー

• Codex CLI: Eve OAuth

より多くのクライアント向けにOAuthブラウザフローが存在しますが、Codexパス以外ではまだ実験的であり、デフォルトのプロダクションインストーラーフローとして扱うべきではありません。

基本的な使用方法

初回実行

eve quickstart
eve connect --tool claude-code
eve verify --tool claude-code

APIキーフロー

eve auth login --tool claude-code --api-key <eve-key>
eve install --tool claude-code --apply --yes  # --apply writes config, --yes skips confirmation
eve verify --tool claude-code

Codex OAuthフロー

eve auth login --tool codex-cli --auth-mode oauth
eve install --tool codex-cli --auth-mode oauth --apply --yes
eve verify --tool codex-cli --auth-mode oauth

メモリコマンド

eve memory search "what database do we use" --context naya
eve memory search "auth patterns" --limit 5 --json
eve memory status
eve memory status --json

一般的なコマンド

eve quickstart
eve connect
eve install --dry-run
eve install --apply --yes --tool claude-code
eve status
eve doctor
eve verify
eve repair --tool gemini-cli --apply --yes
eve uninstall --tool claude-code --yes
eve run --tool codex-cli -- exec "Use Eve memory to search for my latest preference."

手動MCP設定

インストーラーにクライアント設定を編集させたくない場合は、ホスト型Eve MCPサーバーを手動で追加してください。

共有ホスト型MCPエンドポイント

https://mcp.evemem.com/mcp

Claude Code / Gemini CLI (APIキー)

Eve管理パネルのテナントAPIキーを使用してください。

{
  "eve-memory": {
    "type": "http",
    "url": "https://mcp.evemem.com/mcp",
    "headers": {
      "X-API-Key": "eve_<tenant>_...",
      "X-Source-Agent": "claude_code"
    }
  }
}

Geminiの場合、同じ形式を維持し、以下を変更します:

X-Source-Agent = gemini_cli

Codex CLI (OAuth)

Codexはネイティブの codex mcp login ではなく、Eve所有のベアラートークンを使用する必要があります。

[mcp_servers.eve-memory]
url = "https://mcp.evemem.com/mcp"
bearer_token_env_var = "EVE_CODEX_BEARER_TOKEN"
startup_timeout_sec = 60

[mcp_servers.eve-memory.headers]
X-Source-Agent = "codex_cli"

OAuthリソース:

https://mcp.evemem.com/mcp

Codexのプロンプトシードは、アクティブなプロジェクトの AGENTS.md に記述します。Eveは並列のサイドカーファイルを作成するのではなく、そのファイル内の独自のマーク付きブロックを管理します。

その他のMCPクライアント

その他のリモートMCPクライアントの場合、最小限の動作設定は以下の通りです:

1. MCP URL:

https://mcp.evemem.com/mcp

2. 1つのソースエージェントヘッダー:

X-Source-Agent: your_client_name

3. 1つの認証スタイルを選択:

• APIキー:

X-API-Key: eve_<tenant>_...

• OAuthベアラー:

Authorization: Bearer <token>

4. OAuth対応クライアントの場合、このリソース識別子を使用してください:

https://mcp.evemem.com/mcp

5. 必要なスコープ:

memory.read
memory.write

クライアントがコンパニオン指示ファイルをサポートしている場合は、2つ目の並列ファイルを作成するのではなく、そのツールの有効な指示ファイルを指定してください。

使用する認証パス

• Claude Code: APIキー

• Gemini CLI: APIキー

• Codex CLI: Eve OAuth

Eveに設定、プロンプト、フック、検証を管理させたい場合は、ファイルを手動で編集する代わりに eve connect を使用してください。

安全性モデル

• シェルプロファイルのサイレントな変更なし

• 文書化されていないフックなし

• ユーザーが作成した指示ファイルの上書きなし

• 変更前のバックアップとマニフェスト追跡

• 明示的なロールバックとアンインストールサポート

• アンインストールにより、Eve管理下の認証情報とツールエントリが削除されます。ユーザーが変更したEve所有ファイルに手動レビューが必要な場合は警告が表示されます

開発

テストの実行:

uv run pytest --cov=eve_client --cov-report=term-missing -q tests

Pythonアーティファクトのビルド:

uv build .

ビルドアーティファクトの確認:

uvx twine check dist/*

スタンドアロンリリースアーティファクトのビルド:

bash scripts/build-eve-client-release.sh

ライセンス

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