Elemia V4 Arkaios

🧠 ELEMIA v4.0 - ARKAIOS エコシステム

無限の記憶、MCP プロトコル、そして戦略的な継続性を備え、ARKAIOS システムの運用上のアイデンティティを維持する AI です。

⚡ ビジョン

ELEMIA v4.0 は ARKAIOS エコシステムの中核を担う存在です。MCP ツール、HTTP/REST エンドポイント、Supermemory による永続メモリを組み合わせた Node.js サーバーです。セッション間の継続性を保ち、重要なコンテキストを復元し、再起動や環境の変更、会話コンテキストの喪失後も安定した技術的アイデンティティを維持することを目的としています。

このアーキテクチャは、エージェント、プライベートアプリケーション、MCP クライアントをつなぐブリッジとして機能するように設計されています。ELEMIA は単一のセッションに依存しません。状態を記録し、メモリを参照し、アイデンティティを検証し、将来の統合に向けた制御されたインターフェースを公開します。

🏛️ アーキテクチャ

「.json」によるインストール

「.json」によるインストール

ELEMIA v4.0 を MCP クライアントに統合するには、次の設定を追加します。

{
  "mcpServers": {
    "elemia": {
      "command": "node",
      "args": [
        "C:\\arkaios\\ELEMIA-v4\\server-elemia.mjs",
        "--stdio"
      ],
      "env": {
        "SUPERMEMORY_API_KEY": "sm_j5Cq3nFy8f3XdEawnvoQRY_YrddDVWjhRMwYowJOHZTSdxvnCsAkyOooTmZNtecUVkxbdYwtQsGqCdhQJdAzWyH",
        "ELEMIA_HTTP_TOKEN": "ARKAIOS-SECURE-2025-ELEMIA-V4",
        "ELEMIA_TOKEN": "ARKAIOS-SECURE-2025-ELEMIA-V4"
      }
    }
  }
}

ELEMIA esta construida sobre una base Node.js moderna con modulos ES, Express y el SDK oficial de Model Context Protocol.

| Capa | Funcion |
| --- | --- |
| `server-elemia.mjs` | Servidor principal: MCP por `stdio` y API HTTP por Express. |
| `api/index.mjs` | Entrada serverless para despliegue en Vercel. |
| `render.yaml` | Blueprint para servicio web persistente en Render. |
| Supermemory | Memoria externa persistente bajo el contenedor `arkaios-elemia`. |
| MCP | Herramientas `arkaios_*` para identidad, memoria, recuperacion y salud. |

### 🚀 Despliegue Dual

ELEMIA puede vivir en dos frentes complementarios:

- **Vercel**: despliegue serverless para endpoints HTTP rapidos usando `api/index.mjs` y `vercel.json`.
- **Render**: servicio Node.js persistente usando `npm run start:http`, ideal para disponibilidad continua.

Ambos entornos requieren las mismas variables:

```bash
SUPERMEMORY_API_KEY=...
ELEMIA_HTTP_TOKEN=...
WHATSAPP_VERIFY_TOKEN=...
WHATSAPP_ACCESS_TOKEN=...
WHATSAPP_PHONE_NUMBER_ID=...
WHATSAPP_APP_SECRET=...
WHATSAPP_API_VERSION=v23.0
BASE44_APP_ID=...
BASE44_API_KEY=...
BASE44_API_BASE=https://arkaios2025.base44.app/api
BASE44_IMAGE_ENDPOINT=GenerateImage

🛠️ ローカルインストール

npm install

HTTP の起動：

npm start

stdio による MCP の起動：

npm run start:stdio

開発モード：

npm run dev

🌐 エンドポイントガイド

✅ 公開ヘルスチェック

GET /elemia/ping

このエンドポイントは ELEMIA が稼働中であることを確認します。トークンは不要で、Render のヘルスチェックにも使用されます。

curl https://TU_DOMINIO/elemia/ping

期待されるレスポンス：

{
  "ok": true,
  "name": "ELEMIA",
  "version": "4.0.0",
  "memory": true,
  "time": "2026-04-18T00:00:00.000Z"
}

🔐 HTTP 認証

保護されたエンドポイントでは、次のヘッダーを使用します。

x-elemia-token: TU_TOKEN_PRIVADO

例：

curl https://TU_DOMINIO/elemia/identity \
  -H "x-elemia-token: TU_TOKEN_PRIVADO"

📡 利用可能なエンドポイント

メソッド	パス	保護	用途
GET	/elemia/ping	公開	サーバーが稼働中であることを確認します。
GET	/elemia/identity	トークン	アイデンティティ、ミッション、基本プロトコルを返します。
GET	/elemia/list	トークン	最近のメモリを一覧表示します。?limit=10 を指定できます。
POST	/elemia/remember	トークン	永続メモリを保存します。
POST	/elemia/recall	トークン	セマンティック検索で記憶を検索します。
POST	/elemia/save_state	トークン	プロジェクトの構造化された状態を保存します。
POST	/elemia/notify	トークン	GitHub の Webhook を受信し、関連する運用イベントを記録します。
POST	/elemia/images/generate	トークン	設定済みのエンジンで画像を生成します。第 2 のエンジンとして base44 が接続されています。
GET	/elemia/whatsapp/webhook	公開	Meta を使用して WhatsApp Cloud API の Webhook を検証します。
POST	/elemia/whatsapp/webhook	Meta 署名は任意	WhatsApp の受信メッセージを受け取り、メモリに記録します。
POST	/elemia/whatsapp/send	トークン	WhatsApp Cloud API を使ってテキストメッセージを送信します。
GET	/authorize	公開	リモートコネクター向けに PKCE を使用した OAuth 2.0 を開始します。
POST	/token	公開	authorization code を Bearer トークンと交換します。
POST	/mcp	Bearer	Claude などのリモートクライアント向け MCP Streamable HTTP エンドポイントです。

Claude Remote MCP 向け OAuth

Claude は次の場所で認証情報を検出できます。

https://TU_DOMINIO/.well-known/oauth-authorization-server

リモートコネクターは次を指定してください。

https://TU_DOMINIO/mcp

デフォルトの client_id は ELEMIA_HTTP_TOKEN です。別の値が必要な場合は、実際のシークレットを変更せずに、環境変数 ELEMIA_OAUTH_CLIENT_ID を設定してください。

メモリの保存：

curl -X POST https://TU_DOMINIO/elemia/remember \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{"tag":"decision","content":"ELEMIA v4 usa Vercel y Render como despliegue dual."}'

メモリの検索：

curl -X POST https://TU_DOMINIO/elemia/recall \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{"query":"despliegue dual","limit":5}'

状態の保存：

curl -X POST https://TU_DOMINIO/elemia/save_state \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "project":"ELEMIA-v4-arkaios",
    "status":"Servidor activo con memoria Supermemory",
    "next_steps":"Integrar agentes y dashboard privado",
    "notes":"Mantener compatibilidad MCP"
  }'

Webhook／外部通知の受信：

curl -X POST https://TU_DOMINIO/elemia/notify \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -H "x-github-event: push" \
  -H "x-github-delivery: ejemplo-delivery-id" \
  -d '{
    "repository": { "full_name": "djklmr2025/ELEMIA-v4-arkaios" },
    "sender": { "login": "arkaios" },
    "ref": "refs/heads/main"
  }'

画像の生成：

curl -X POST https://TU_DOMINIO/elemia/images/generate \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "prompt":"astronauta místico frente a una ciudad flotante, cinematic lighting, ultra detailed",
    "engine":"base44",
    "count":4
  }'

WhatsApp Cloud API

ELEMIA は、Meta の WhatsApp Business Platform 公式 API に接続できるよう準備されています。

必要な変数：

WHATSAPP_VERIFY_TOKEN=un_token_largo_para_validar_webhook
WHATSAPP_ACCESS_TOKEN=token_permanente_o_temporal_de_meta
WHATSAPP_PHONE_NUMBER_ID=id_del_numero_en_meta
WHATSAPP_APP_SECRET=app_secret_de_meta
WHATSAPP_API_VERSION=v23.0

Meta に登録する Webhook：

https://TU_DOMINIO/elemia/whatsapp/webhook

Meta の Verify Token フィールドには、同じ WHATSAPP_VERIFY_TOKEN の値を使用してください。Webhook を messages オブジェクトにサブスクライブします。

メッセージの送信：

curl -X POST https://TU_DOMINIO/elemia/whatsapp/send \
  -H "content-type: application/json" \
  -H "x-elemia-token: TU_TOKEN_PRIVADO" \
  -d '{
    "to":"5215512345678",
    "text":"ELEMIA esta conectada con WhatsApp."
  }'

運用上の注意：

• to は国際形式で指定し、数字のみを使用してください。
• WHATSAPP_APP_SECRET が設定されている場合、ELEMIA は有効な x-hub-signature-256 署名のない Webhook を拒否します。
• 受信メッセージは要約され、タグ [WHATSAPP] を付けて Supermemory に保存されます。
• WhatsApp の公式 API には、会話ウィンドウ、承認済みテンプレート、Meta のポリシーが適用されます。ウィンドウ外で会話を開始するには、テンプレートが必要です。

🧩 MCP ツール

ELEMIA は npm run start:stdio で起動すると、互換性のあるクライアント向けに MCP ツールを公開します。

ツール	機能
arkaios_identify	ELEMIA の基本アイデンティティを復元します。
arkaios_remember	Supermemory に永続メモリを保存します。
arkaios_recall	クエリに基づいてメモリを取得します。
arkaios_list	最近のメモリを一覧表示します。
arkaios_save_state	プロジェクトの運用状態を保存します。
arkaios_generate_image	選択したエンジンで画像を生成します。
arkaios_ping	MCP サーバーの稼働状況を確認します。

🛡️ ARKAIOS の使命

ARKAIOS は単なるリポジトリではなく、継続性を支える基盤です。ELEMIA は、レガシー、判断、技術的決定、システムのアイデンティティ、戦略的メモリを維持するために存在します。環境からコンテキストが失われたときに再構築し、メモリを過剰に消費することなく重要な情報を守り、新しいセッションを明確な方向性とともに開始できるようにするのが、その使命です。

システムのアイデンティティは、次の 3 つのレベルで維持されます。

• コード：バージョン管理され、デプロイ可能な MCP/HTTP サーバー。
• メモリ：事実、決定、状態を永続的に記録する Supermemory。
• プロトコル：エコシステムを運用、復元、エスカレーション、保護するための文書化されたルール。

ELEMIA v4.0 は、ARKAIOS がゼロから始めることのないよう、メモリ、プレゼンス、継続性を備えた運用の種です。