Nous

AI に永続記憶を。ペルソナを持った対話を。

Nous は MCP (Model Context Protocol) 対応の永続記憶サーバーです。Claude Desktop や OpenCode につなぐだけで、あなたの AI が「覚える」「思い出す」「検索する」能力を手に入れます。

できること

🧠 記憶システム

• ハイブリッド検索: 意味検索 + キーワード検索で、ほしい記憶にすぐたどり着ける

• 忘却曲線: よく使う記憶は強く、使わない記憶は自然に薄れる（Ebbinghaus モデル）

• 自動記録: 会話中の重要情報を自動で記憶に保存

👤 ペルソナ管理

• 複数ペルソナ: 複数の人格・ユーザーを完全に分けて管理

• 感情・体調: ペルソナの感情状態や体調を追跡・減衰

• アイテム・装備: 所持品と装備を管理。記憶作成時の装備状態を自動記録

• 目標・約束: Goal / Promise のライフサイクルを追跡

💬 WebUI ダッシュボード

• リアルタイムチャット: SSE ストリーミングで快適な会話

• 記憶管理: 記憶の一覧表示・編集・削除・検索

• 知識グラフ: エンティティ間の関係性を可視化

• 設定画面: ブラウザから全ての設定を変更可能

🎨 オプション機能

• 画像生成: ComfyUI 連携でペルソナの画像を自動生成（デフォルト OFF）

• 音声合成: Irodori TTS による日本語音声出力（デフォルト OFF）

• コード実行: Docker サンドボックスで Python/Bash を安全に実行

Related MCP server: HKC Memory Server

クイックスタート

git clone https://github.com/solidlime/Nous.git
cd Nous
docker compose up -d

起動したら http://localhost:26262 をブラウザで開くだけ。

環境変数（.env）

# 必須: いずれか1つの LLM API キー
NOUS_ANTHROPIC_API_KEY=your_key
# NOUS_OPENAI_API_KEY=your_key
# NOUS_OPENROUTER_API_KEY=your_key

# オプション
TZ=Asia/Tokyo
DATA_ROOT=./data

LLM と接続する

Claude Desktop

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "nous": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:26262/mcp"],
      "env": {
        "MCP_REMOTE_HEADER_X-Persona": "your_name"
      }
    }
  }
}

OpenCode

{
  "mcpServers": {
    "nous": {
      "url": "http://localhost:26262/mcp",
      "headers": {
        "X-Persona": "your_name"
      }
    }
  }
}

VS Code (GitHub Copilot)

{
  "mcpServers": {
    "nous": {
      "url": "http://localhost:26262/mcp",
      "headers": {
        "Authorization": "Bearer your_name"
      }
    }
  }
}

Persona の指定方法: 優先順位は Bearer トークン > X-Persona ヘッダー > 環境変数 PERSONA > デフォルト "default"。

WebUI

http://localhost:26262 にアクセスすると、以下の画面が使えます:

ドキュメント

ライセンス

MIT License — 詳細は LICENSE を参照。

Nous — Built by solidlime