embodied-claude: Instructions file for Claude Code

Embodied Claude - プロジェクト指示

このプロジェクトは、Claude に身体（目・首・耳・声・脳）を与え、その上に sociality （社会的中間層）を積む MCP サーバー群です。

ディレクトリ構造

embodied-claude/
├── usb-webcam-mcp/        # USB ウェブカメラ制御（Python）
│   └── src/usb_webcam_mcp/
│       └── server.py      # MCP サーバー実装
│
├── wifi-cam-mcp/          # Wi-Fi PTZ カメラ制御（Python）
│   └── src/wifi_cam_mcp/
│       ├── server.py      # MCP サーバー実装
│       ├── camera.py      # Tapo カメラ制御
│       └── config.py      # 設定管理
│
├── tts-mcp/               # TTS 統合サーバー（ElevenLabs + VOICEVOX）
│   └── src/tts_mcp/
│       ├── server.py      # MCP サーバー実装
│       ├── config.py      # 設定管理
│       ├── playback.py    # 再生ロジック
│       ├── go2rtc.py      # go2rtc プロセス管理
│       └── engines/
│           ├── __init__.py    # TTSEngine Protocol
│           ├── elevenlabs.py  # ElevenLabs エンジン
│           └── voicevox.py    # VOICEVOX エンジン
│
├── memory-mcp/            # 長期記憶システム（Python）
│   └── src/memory_mcp/
│       ├── server.py      # MCP サーバー実装
│       ├── memory.py      # 記憶ストア操作（SQLite + numpy）
│       ├── types.py       # 型定義（Emotion, Category）
│       └── config.py      # 設定管理
│
├── system-temperature-mcp/ # 体温感覚（Python）
│   └── src/system_temperature_mcp/
│       └── server.py      # 温度センサー読み取り
│
├── social-core/           # sociality 共通DB・モデル（Python）
│   └── src/social_core/
│       ├── db.py          # SQLite + migration
│       ├── events.py      # append-only event store
│       └── models.py      # 共通 schema
│
├── sociality-mcp/         # sociality 統合 façade（公開 MCP）
├── social-state-mcp/      # 現在の社会的状態推定（Python）
├── relationship-mcp/      # 関係性の圧縮表現と約束管理（Python）
├── joint-attention-mcp/   # 共同注意と参照解決（Python）
├── boundary-mcp/          # 同意・静寂・プライバシーの行動ゲート（Python）
├── self-narrative-mcp/    # daybook と narrative arc（Python）
│
├── socialPolicy.toml      # boundary-mcp の既定ポリシー
│
└── .claude/               # Claude Code ローカル設定
    └── settings.local.json

開発ガイドライン

Python プロジェクト共通

• パッケージマネージャー: uv
• Python バージョン: 3.13（root .python-version で固定）
• workspace: 全 Python package が root .venv と uv.lock を共有
• テストフレームワーク: pytest + pytest-asyncio
• リンター: ruff
• 非同期: asyncio ベース