alos server

# Digital Nature ALOs MCP Server

ALOを管理するためのMCPサーバー。World、Scene、ALOの階層構造でオブジェクトを管理し、インタラクションを記録することができます。

## 特徴

- インメモリでのデータ管理
- World、Scene、ALOの階層構造
- プロパティ、スキル、知識、状態の管理
- インタラクション履歴の記録

## ツール

1. `world_create`
   - 新しいWorldを作成
   - 必須入力:
     - `name` (string): Worldの名前
   - オプション入力:
     - `description` (string): Worldの説明

2. `world_get`
   - World情報の取得
   - 必須入力:
     - `worldId` (string): WorldのID

3. `scene_create`
   - Sceneの作成
   - 必須入力:
     - `worldId` (string): 親WorldのID
     - `name` (string): Sceneの名前
   - オプション入力:
     - `description` (string): Sceneの説明

4. `scene_get`
   - Scene情報の取得
   - 必須入力:
     - `sceneId` (string): SceneのID

5. `alo_create`
   - ALOの作成
   - 必須入力:
     - `sceneId` (string): SceneのID
     - `name` (string): ALOの名前
     - `properties` (array): ALOのプロパティリスト
       - `name` (string): プロパティ名
       - `value` (string): プロパティ値
     - `skills` (array): ALOのスキルリスト
       - `name` (string): スキル名
       - `active` (boolean): スキルの有効状態
       - `conditions` (object): スキルの発動条件
         - `requiresState` (string): 必要な状態
         - `blockedByState` (string): ブロックする状態
     - `knowledge` (array): ALOの知識リスト
     - `states` (object): ALOの状態
     - `validation` (string): 状態の検証結果
   - オプション入力:
     - `description` (string): ALOの説明
     - `metadata` (object): 追加メタデータ

6. `alo_get`
   - ALO情報の取得
   - 必須入力:
     - `aloId` (string): ALOのID

7. `interaction_create`
   - インタラクションの作成
   - 必須入力:
     - `aloId` (string): ALOのID
     - `type` (string): インタラクションの種類
     - `description` (string): インタラクションの説明
   - オプション入力:
     - `metadata` (object): 追加メタデータ

8. `interaction_get`
   - インタラクション情報の取得
   - 必須入力:
     - `interactionId` (string): インタラクションのID

## セットアップ

### Claude Desktopでの使用

`claude_desktop_config.json`に以下を追加:


#### docker

```json
{
  "mcpServers": {
    "alos": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/alos"
      ]
    }
  }
}
```

## ビルド

Dockerビルド:

```bash
docker build -t mcp/alos -f Dockerfile .
```

## 使用例

1. Worldの作成:
```json
{
  "name": "デジタルネイチャー展示",
  "description": "デジタルネイチャーの展示空間"
}
```

2. Sceneの作成:
```json
{
  "worldId": "world123",
  "name": "メインホール",
  "description": "展示の中心となるホール"
}
```

3. ALOの作成:
```json
{
  "sceneId": "scene123",
  "name": "デジタル植物",
  "description": "インタラクティブな植物オブジェクト",
  "properties": [
    {
      "name": "type",
      "value": "plant"
    },
    {
      "name": "interactiveMode",
      "value": "touch"
    }
  ],
  "skills": [
    {
      "name": "grow",
      "active": true,
      "conditions": {
        "requiresState": "watered",
        "blockedByState": "withered"
      }
    }
  ],
  "knowledge": [
    "光合成の仕組み",
    "成長のパターン",
    "環境への適応"
  ],
  "states": {
    "watered": true,
    "healthy": true,
    "growing": false
  },
  "validation": "健康な状態で水やりされている",
  "metadata": {
    "creator": "Digital Nature Group",
    "version": "1.0"
  }
}
```

4. インタラクションの記録:
```json
{
  "aloId": "alo123",
  "type": "touch",
  "description": "葉に触れる",
  "metadata": {
    "intensity": 0.8,
    "duration": 1.5
  }
}
```

## 注意事項

- データはメモリ上で管理されるため、サーバーの再起動時にデータは失われます
- 複数のクライアントで同時に使用する場合は、データの整合性に注意してください

## ライセンス

このMCPサーバーはMITライセンスの下で提供されています。詳細については、プロジェクトリポジトリのLICENSEファイルを参照してください。