unified-mcp

unified-mcp

OpenMemory と Cipher を束ねるラッパー MCP サーバー。 add_memories / search_memory の1回の呼び出しで両方に同時に記録・検索できる。

構成

Claude Desktop (stdio)
    ↓
unified-mcp.js
    ├→ OpenMemory（mcp-remote Streamable HTTP → localhost:8765）
    └→ Cipher（stdio）

セットアップ

1. 依存インストール

npm install

2. claude_desktop_config.json

macOS

{
  "mcpServers": {
    "unified-memory": {
      "command": "node",
      "args": ["<path-to>/unified-mcp.js"],
      "env": {
        "PATH": "<node-bin-dir>:/usr/local/bin:/usr/bin:/bin",
        "OPENMEMORY_URL": "http://localhost:8765/mcp/claude/http/ubuntu",
        "CIPHER_CMD": "<node-bin-dir>/cipher",
        "CIPHER_CWD": "<path-to>/cipher",
        "CIPHER_AGENT_CONFIG": "<path-to>/cipher.yml",
        "NPX_PATH": "<node-bin-dir>/npx",
        "OPENAI_API_KEY": "sk-proj-...",
        "MCP_SERVER_MODE": "aggregator",
        "USE_ASK_CIPHER": "true"
      }
    }
  }
}

• <node-bin-dir>: nodebrew 等の bin ディレクトリ（例: ~/.nodebrew/current/bin）
• CIPHER_AGENT_CONFIG を指定すると cipher --mode mcp --agent <config> で直接起動
• NPX_PATH を指定すると、そのディレクトリが PATH に自動追加される

Windows

{
  "mcpServers": {
    "unified-memory": {
      "command": "node",
      "args": ["<path-to>\\unified-mcp.js"],
      "env": {
        "OPENMEMORY_URL": "http://localhost:8765/mcp/claude/http/ubuntu",
        "CIPHER_CMD": "npm.cmd",
        "CIPHER_CWD": "<path-to>\\cipher",
        "OPENAI_API_KEY": "sk-proj-...",
        "MCP_SERVER_MODE": "aggregator",
        "USE_ASK_CIPHER": "true",
        "PATH": "C:\\Program Files\\nodejs;C:\\Windows\\System32"
      }
    }
  }
}

• CIPHER_AGENT_CONFIG 未指定時は npm run mcp で起動（Windows 向け）

Claude Code

~/.claude.json の mcpServers に追加する。 Cipher aggregator モードには MCP_SERVER_MODE と USE_ASK_CIPHER が必要。

{
  "mcpServers": {
    "unified-memory": {
      "type": "stdio",
      "command": "node",
      "args": ["<path-to>/unified-mcp.js"],
      "env": {
        "PATH": "<node-bin-dir>:/usr/local/bin:/usr/bin:/bin",
        "OPENMEMORY_URL": "http://localhost:8765/mcp/claude/http/ubuntu",
        "CIPHER_CMD": "<node-bin-dir>/cipher",
        "CIPHER_CWD": "<path-to>/cipher",
        "CIPHER_AGENT_CONFIG": "<path-to>/cipher.yml",
        "NPX_PATH": "<node-bin-dir>/npx",
        "OPENAI_API_KEY": "sk-proj-...",
        "MCP_SERVER_MODE": "aggregator",
        "USE_ASK_CIPHER": "true"
      }
    }
  }
}

3. 環境変数

| 変数 | 説明 | 必須 | |------|------|------| | OPENMEMORY_URL | OpenMemory の mcp-remote エンドポイント | ✅ | | CIPHER_CMD | Cipher の実行コマンド（macOS: フルパス, Windows: npm.cmd） | ✅ | | CIPHER_CWD | Cipher の作業ディレクトリ | ✅ | | OPENAI_API_KEY | Cipher が使う OpenAI API キー | ✅ | | NPX_PATH | npx のフルパス（macOS でPATH が通らない場合） | | | CIPHER_AGENT_CONFIG | cipher.yml のパス（指定時は直接起動） | | | MCP_SERVER_MODE | Cipher サーバーモード（aggregator で全ツール公開） | ✅ | | USE_ASK_CIPHER | true で ask_cipher ツールを有効化 | ✅ |

ツール

| ツール名 | 説明 | |---------|------| | add_memories | OpenMemory と Cipher の両方に記憶を保存 | | search_memory | OpenMemory と Cipher の両方から検索 |

前提

• OpenMemory が Docker で起動済み
• Cipher が起動できる状態
• OpenMemory には mcp-remote 経由で Streamable HTTP 接続