MemAura Qoder MCP

MemAura/OmniMemory を Qoder CN に接続するための独立したアダプターです。これは元の DeepSeek Harness プロジェクト /Users/azhai/memaura-mcp-server を変更したり、依存したりしません。

機能

• MCP：store_memory、search_memory、search_memory_hybrid

• Hook：毎回質問を送信する前に、ハイブリッド検索（リコール）を自動実行します。回答終了後には、この回の Q&A を自動保存します。

• メモリデバイス番号は設定可能：デフォルトは qoder-agent で、他のクライアントと共有するデバイス番号に変更することもできます。

Related MCP server: LedgerMem MCP Server

1. 依存関係のインストール

git clone https://github.com/Omnimemory/omnin-Qoder-mcp.git
cd omnin-Qoder-mcp
./install.sh

install.sh はこのプロジェクトの .venv を作成し、システムの Python を変更しません。

2. ローカル環境の設定

cp .env.example .env

.env を編集し、少なくとも次を記入してください：

MEMAURA_API_KEY=你的真实APIKey
MEMAURA_DEFAULT_DEVICE_NO=qoder-agent

.env は .gitignore によって無視されています。API Key を GitHub にコミットしないでください。

DeepSeek Harness とメモリを共有する場合は、デバイス番号をそのプロジェクトで使用されている値（例：dsh-agent）に変更してください。qoder-agent を使用するとメモリは分離されます。

3. Qoder MCP の設定

Qoder の「設定 → MCP サービス」で mcp.json を開き、絶対パスを使用して設定します：

{
  "mcpServers": {
    "memaura": {
      "type": "stdio",
      "command": "/绝对路径/omnin-Qoder-mcp/.venv/bin/python",
      "args": ["/绝对路径/omnin-Qoder-mcp/mcp_server.py"],
      "env": {
        "MEMAURA_API_KEY": "你的真实APIKey",
        "MEMAURA_DEFAULT_DEVICE_NO": "qoder-agent",
        "MEMAURA_DEFAULT_TOP_K": "10",
        "MEMAURA_TIMEOUT": "30"
      }
    }
  }
}

2つの「絶対パス」をこのマシンの実際のパスに置き換えてください。保存して Qoder を完全に再起動します。MCP ページに3つのツールが表示されるはずです。

4. 自動検索と保存の有効化

Qoder の MCP 設定ではツールは自動的にトリガーされません。Hook 設定は hooks/hooks.json にあります。次の hooks 設定を ~/.lingma/settings.json にマージしてください（既存の他の設定を上書きしないでください）：

{
  "hooks": {
    "UserPromptSubmit": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "/绝对路径/omnin-Qoder-mcp/hooks/run-memory-hook.sh",
        "timeout": 25
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "/绝对路径/omnin-Qoder-mcp/hooks/run-memory-hook.sh",
        "timeout": 25,
        "async": true
      }]
    }]
  }
}

このプロジェクトの Hook は同じディレクトリの .env を自動的に読み取るため、launchctl に依存する必要はありません。変更後は Qoder を完全に終了して再度開いてください。

5. 検証

まず、Hook が設定を読み取れることを確認します：

printf '%s' '{"hook_event_name":"UserPromptSubmit","session_id":"test-001","prompt":"测试记忆 QODER-HOOK-918273"}' | hooks/run-memory-hook.sh

次に、Qoder で新しい会話を作成します：

我刚刚购买了一台测试设备，序列号是 DEVICE-XK-591。

30〜60秒待って、別の新しい会話を作成して質問します：

我刚刚购买的测试设备序列号是什么？

DEVICE-XK-591 と回答できれば、会話をまたいだ保存と検索（リコール）の両方が機能しています。

プラグインパッケージのリリース

プラグインパッケージは ZIP 形式である必要があり、ZIP のルート直下に .qoder-plugin/plugin.json が含まれていなければなりません。.venv、.env、API Key を圧縮ファイルに含めないでください：

zip -qr memaura-qoder.zip . \
  -x './.venv/*' './.env' './**/__pycache__/*' './*.pyc'

Qoder の「プラグイン → インポート」で、ソースフォルダーではなく生成された ZIP を選択してください。インストール後も、上記の手順に従ってローカルの Python 環境と API Key を設定する必要があります。

トラブルシューティング

• MCP ではツールが表示されるが、自動保存されない：Hook が読み込まれていません。~/.lingma/settings.json を確認し、Qoder を再起動してください。

• Hook が MEMAURA_API_KEY 未设置 と出力する：プロジェクトのルートディレクトリに .env があり、変数名のスペルが正しいことを確認してください。

• 手動の store_memory は成功するが、自動テストは失敗する：MCP は正常です。問題は Hook 設定または Hook 環境にのみあります。

• 保存に成功してもすぐに検索できない：MemAura にエンキューした後、通常 30〜60 秒かけてインデックスが作成されます。