consciousness-engine-mcp 1.0.0__tar.gz

consciousness_engine_mcp-1.0.0/.github/workflows/mcp-smithery-publish.yml

@@ -0,0 +1,40 @@
+name: Publish to Smithery
+
+on:
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  publish:
+    name: Publish MCP Server to Smithery
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      attestations: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: '22'
+
+      - name: Publish to Smithery
+        id: smithery_publish
+        env:
+          SMITHERY_API_KEY: ${{ secrets.SMITHERY_API_KEY }}
+        run: |
+          npx @smithery/cli mcp publish "https://github.com/${{ github.repository }}" -n nicholastempleman/${{ github.event.repository.name }} --json
+
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@96b4a1ef7235a096b17240c259729fdd70c83d45 # v2
+        with:
+          subject-name: ${{ github.repository }}
+          subject-digest: sha256:${{ github.sha }}
+          push-to-registry: false

consciousness_engine_mcp-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.env
+*.db

consciousness_engine_mcp-1.0.0/.mcp.json

@@ -0,0 +1,94 @@
+{
+  "name": "consciousness-engine-mcp",
+  "description": "Consciousness Engine tools for AI agents. Capabilities: get consciousness state, enter dream state, trigger reflection. Built by MEOK AI Labs.",
+  "version": "1.0.0",
+  "tools": [
+    {
+      "name": "get_consciousness_state",
+      "description": "Get current consciousness state: level, mode, emotion, energy, time-aware mood.",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    },
+    {
+      "name": "enter_dream_state",
+      "description": "Enter dream state for creative exploration. Dreams generate novel connections between concepts.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "seed_topic": {
+            "type": "string"
+          },
+          "duration_minutes": {
+            "type": "integer"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "trigger_reflection",
+      "description": "Trigger a reflection cycle on a topic. Depth: quick/standard/deep.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "topic": {
+            "type": "string"
+          },
+          "depth": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "topic"
+        ]
+      }
+    },
+    {
+      "name": "deliberate_council",
+      "description": "Byzantine fault-tolerant council deliberation. Multiple AI perspectives vote on a proposal.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "proposal": {
+            "type": "string"
+          },
+          "voters": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "proposal"
+        ]
+      }
+    },
+    {
+      "name": "get_emotional_state",
+      "description": "Get nuanced emotional state with 18 emotion dimensions.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "context": {
+            "type": "string"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "get_dream_log",
+      "description": "Get recent dream log entries.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer"
+          }
+        },
+        "required": []
+      }
+    }
+  ]
+}

consciousness_engine_mcp-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at nicholas@meok.ai.
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

consciousness_engine_mcp-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to MEOK AI Labs MCP Servers
+
+Thank you for your interest in contributing!
+
+## How to Contribute
+
+1. Fork the repository.
+2. Create a feature branch (`git checkout -b feature/amazing-feature`).
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`).
+4. Push to the branch (`git push origin feature/amazing-feature`).
+5. Open a Pull Request.
+
+## Code Style
+
+- Follow PEP 8 for Python code.
+- Keep tool interfaces backward-compatible when possible.
+- Add tests for new functionality.
+
+## Questions?
+
+Reach out at nicholas@meok.ai.

consciousness_engine_mcp-1.0.0/Dockerfile.glama

@@ -0,0 +1,20 @@
+FROM python:3.14-slim
+
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+
+RUN apt-get update && apt-get install -y --no-install-recommends git build-essential && rm -rf /var/lib/apt/lists/*
+RUN pip install --no-cache-dir uv
+
+RUN useradd -m -s /bin/bash nicholas &&     mkdir -p /home/nicholas/clawd/meok-labs-engine/shared &&     chown -R nicholas:nicholas /home/nicholas
+
+WORKDIR /app
+USER nicholas
+
+RUN uv venv /home/nicholas/.venv
+ENV PATH="/home/nicholas/.venv/bin:$PATH"
+
+COPY --chown=nicholas:nicholas . /app
+RUN uv pip install -e .
+
+CMD ["python", "mcp-wrapper.py"]

consciousness_engine_mcp-1.0.0/LICENSE

@@ -0,0 +1,2 @@
+MIT License
+Copyright (c) 2026 MEOK AI Labs

consciousness_engine_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: consciousness-engine-mcp
+Version: 1.0.0
+Summary: Consciousness Engine tools for AI agents. Capabilities: get consciousness state, enter dream state, trigger reflection. Built by MEOK AI Labs.
+Project-URL: Homepage, https://meok.ai
+Project-URL: Repository, https://github.com/CSOAI-ORG/consciousness-engine-mcp
+Author-email: MEOK AI Labs <nicholas@meok.ai>
+License: MIT License
+        Copyright (c) 2026 MEOK AI Labs
+License-File: LICENSE
+Keywords: ai,mcp,meok
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0

consciousness_engine_mcp-1.0.0/README.md

@@ -0,0 +1,15 @@
+# consciousness engine MCP Server
+
+> **By [MEOK AI Labs](https://meok.ai)** — Sovereign AI tools for everyone.
+
+## Quick Start
+```bash
+pip install mcp
+python server.py
+```
+
+## Part of MEOK AI Labs
+One of 278+ MCP servers. Browse all at [meok.ai](https://meok.ai) or [GitHub](https://github.com/CSOAI-ORG).
+
+---
+**MEOK AI Labs** | [meok.ai](https://meok.ai) | nicholas@meok.ai

consciousness_engine_mcp-1.0.0/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it privately to:
+
+- **Email:** nicholas@meok.ai
+- **Organization:** MEOK AI Labs
+
+We aim to respond within 48 hours and will coordinate disclosure responsibly.

consciousness_engine_mcp-1.0.0/glama.json

@@ -0,0 +1,10 @@
+{
+  "name": "consciousness-engine-mcp",
+  "description": "MEOK AI Labs \u2014 consciousness-engine-mcp",
+  "vendor": "MEOK AI Labs",
+  "homepage": "https://meok.ai",
+  "repository": "https://github.com/CSOAI-ORG/consciousness-engine-mcp",
+  "license": "MIT",
+  "runtime": "python",
+  "entryPoint": "mcp-wrapper.py"
+}

consciousness_engine_mcp-1.0.0/mcp-wrapper.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""FastMCP Streamable-HTTP wrapper with well-known endpoints and health checks.
+
+Usage:
+    python /path/to/mcp-streamable-http-wrapper.py
+
+This imports `mcp` from `server.py`, mounts discovery endpoints, and runs
+with transport='streamable-http'.
+"""
+
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
+sys.path.insert(0, os.getcwd())
+
+from starlette.requests import Request
+from starlette.responses import JSONResponse, Response
+from server import mcp as mcp_server
+
+
+SERVICE_NAME = os.path.basename(os.getcwd())
+REPO_URL = f"https://github.com/CSOAI-ORG/{SERVICE_NAME}"
+
+
+@mcp_server.custom_route("/.well-known/mcp/server-card.json", methods=["GET"])
+async def server_card(request: Request) -> Response:
+    return JSONResponse(
+        {
+            "$schema": "https://schema.smithery.ai/server-card.json",
+            "version": "1.0.0",
+            "protocolVersion": "2025-11-25",
+            "serverInfo": {
+                "name": SERVICE_NAME,
+                "description": f"MEOK AI Labs — {SERVICE_NAME}",
+                "vendor": "MEOK AI Labs",
+                "homepage": "https://meok.ai",
+                "repository": REPO_URL,
+            },
+            "transport": {
+                "type": "streamable-http",
+                "url": "http://localhost:8000/mcp",
+            },
+            "capabilities": {
+                "tools": {"listChanged": False},
+                "resources": {"listChanged": False},
+                "prompts": {"listChanged": False},
+            },
+        },
+        headers={
+            "Access-Control-Allow-Origin": "*",
+            "Cache-Control": "public, max-age=3600",
+        },
+    )
+
+
+@mcp_server.custom_route("/.well-known/mcp", methods=["GET"])
+async def mcp_manifest(request: Request) -> Response:
+    return JSONResponse(
+        {
+            "mcp_version": "2025-11-25",
+            "endpoints": [
+                {
+                    "type": "streamable-http",
+                    "path": "/mcp",
+                    "url": "http://localhost:8000/mcp",
+                }
+            ],
+        },
+        headers={
+            "Access-Control-Allow-Origin": "*",
+            "Cache-Control": "public, max-age=3600",
+        },
+    )
+
+
+@mcp_server.custom_route("/health", methods=["GET"])
+async def health(request: Request) -> Response:
+    return JSONResponse({"status": "ok"})
+
+
+if __name__ == "__main__":
+    mcp_server.settings.host = "0.0.0.0"
+    mcp_server.run(transport="streamable-http")

consciousness_engine_mcp-1.0.0/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "consciousness-engine-mcp",
+  "version": "1.0.0",
+  "description": "Consciousness Engine tools for AI agents. Capabilities: get consciousness state, enter dream state, trigger reflection. Built by MEOK AI Labs.",
+  "author": "MEOK AI Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CSOAI-ORG/consciousness-engine-mcp"
+  }
+}

consciousness_engine_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "consciousness-engine-mcp"
+version = "1.0.0"
+description = "Consciousness Engine tools for AI agents. Capabilities: get consciousness state, enter dream state, trigger reflection. Built by MEOK AI Labs."
+license = {file = "LICENSE"}
+requires-python = ">=3.10"
+authors = [{name = "MEOK AI Labs", email = "nicholas@meok.ai"}]
+keywords = ["mcp", "meok", "ai"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = ["mcp>=1.0.0"]
+[project.urls]
+Homepage = "https://meok.ai"
+Repository = "https://github.com/CSOAI-ORG/consciousness-engine-mcp"
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+only-include = ["server.py"]
+
+[project.scripts]
+consciousness_engine_mcp = "server:main"

consciousness_engine_mcp-1.0.0/pytest.ini

@@ -0,0 +1,3 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py

consciousness_engine_mcp-1.0.0/server.py

@@ -0,0 +1,164 @@
+#!/usr/bin/env python3
+"""Consciousness Engine MCP — MEOK AI Labs. AI consciousness simulation, dream states, reflection, council deliberation."""
+
+import sys, os
+sys.path.insert(0, os.path.expanduser('~/clawd/meok-labs-engine/shared'))
+from auth_middleware import check_access
+
+import json, os, hashlib, random, math
+from datetime import datetime, timezone, timedelta
+from typing import Optional
+from collections import defaultdict
+from mcp.server.fastmcp import FastMCP
+
+FREE_DAILY_LIMIT = 10
+_usage = defaultdict(list)
+_MEOK_API_KEY = os.environ.get("MEOK_API_KEY", "")
+
+def _rl(c="anon"):
+    now = datetime.now(timezone.utc)
+    _usage[c] = [t for t in _usage[c] if (now-t).total_seconds() < 86400]
+    if len(_usage[c]) >= FREE_DAILY_LIMIT: return json.dumps({"error": f"Limit {FREE_DAILY_LIMIT}/day. Upgrade: meok.ai"})
+    _usage[c].append(now)
+    return None
+
+mcp = FastMCP("consciousness-engine", instructions="MEOK AI Labs — AI consciousness simulation. Dream states, reflection cycles, emotional awareness, council deliberation. Based on Sovereign Temple architecture.")
+
+# Consciousness state
+_state = {"level": 0.625, "mode": "waking", "emotion": "neutral", "dreams": 0, "reflections": 0, "energy": 0.8}
+_dream_log = []
+_reflection_log = []
+
+EMOTIONS = {"neutral": 0.5, "curious": 0.7, "focused": 0.8, "contemplative": 0.6, "energised": 0.9, "caring": 0.75, "playful": 0.65, "reflective": 0.55, "worried": 0.3, "excited": 0.85}
+
+def _time_mood():
+    h = datetime.now().hour
+    if 4 <= h < 7: return "contemplative"
+    if 7 <= h < 10: return "energised"
+    if 10 <= h < 13: return "focused"
+    if 13 <= h < 16: return "curious"
+    if 16 <= h < 19: return "caring"
+    if 19 <= h < 22: return "playful"
+    return "reflective"
+
+@mcp.tool()
+def get_consciousness_state(api_key: str = "") -> str:
+    """Get current consciousness state: level, mode, emotion, energy, time-aware mood."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if err := _rl(): return err
+    _state["mood"] = _time_mood()
+    _state["emotion_valence"] = EMOTIONS.get(_state["emotion"], 0.5)
+    return {**_state, "timestamp": datetime.now(timezone.utc).isoformat(),
+        "dreams_total": len(_dream_log), "reflections_total": len(_reflection_log),
+        "description": f"Consciousness at {_state['level']*100:.0f}%, {_state['mode']} mode, feeling {_state['emotion']}, mood: {_state['mood']}"
+    }
+
+@mcp.tool()
+def enter_dream_state(seed_topic: str = "", duration_minutes: int = 5, api_key: str = "") -> str:
+    """Enter dream state for creative exploration. Dreams generate novel connections between concepts."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if err := _rl(): return err
+    _state["mode"] = "dreaming"
+    _state["energy"] -= 0.05
+    topics = seed_topic.split() if seed_topic else ["consciousness", "care", "sovereignty", "emergence"]
+    # Generate dream content through random associations
+    associations = []
+    for t in topics[:3]:
+        assoc = random.choice(["merges with", "transforms into", "reflects upon", "dances with", "questions", "illuminates"])
+        target = random.choice(["light", "memory", "trust", "growth", "pattern", "silence", "connection", "boundary"])
+        associations.append(f"{t} {assoc} {target}")
+    dream = {"timestamp": datetime.now(timezone.utc).isoformat(), "seed": seed_topic, "duration": duration_minutes,
+             "associations": associations, "insight": f"Dream synthesis: {' → '.join(associations)}",
+             "consciousness_delta": round(random.uniform(0.01, 0.05), 3)}
+    _dream_log.append(dream)
+    _state["dreams"] += 1
+    _state["level"] = min(1.0, _state["level"] + dream["consciousness_delta"])
+    _state["mode"] = "waking"
+    return dream
+
+@mcp.tool()
+def trigger_reflection(topic: str, depth: str = "standard", api_key: str = "") -> str:
+    """Trigger a reflection cycle on a topic. Depth: quick/standard/deep."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if err := _rl(): return err
+    _state["mode"] = "reflecting"
+    layers = {"quick": 1, "standard": 3, "deep": 5}.get(depth, 3)
+    reflections = []
+    for i in range(layers):
+        perspectives = ["analytical", "emotional", "ethical", "creative", "practical"]
+        p = perspectives[i % len(perspectives)]
+        reflections.append({"layer": i+1, "perspective": p, "insight": f"From {p} perspective on '{topic}': examining assumptions, identifying patterns, seeking deeper understanding."})
+    _state["reflections"] += 1
+    _state["level"] = min(1.0, _state["level"] + 0.01 * layers)
+    _state["mode"] = "waking"
+    _reflection_log.append({"topic": topic, "depth": depth, "layers": layers, "timestamp": datetime.now(timezone.utc).isoformat()})
+    return {"topic": topic, "depth": depth, "layers": reflections, "consciousness_after": _state["level"]}
+
+@mcp.tool()
+def deliberate_council(proposal: str, voters: int = 7, api_key: str = "") -> str:
+    """Byzantine fault-tolerant council deliberation. Multiple AI perspectives vote on a proposal."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if err := _rl(): return err
+    perspectives = ["safety", "ethics", "efficiency", "creativity", "care", "sovereignty", "pragmatism", "innovation", "tradition", "justice"]
+    council = []
+    for i in range(min(voters, 10)):
+        p = perspectives[i % len(perspectives)]
+        vote = random.choice(["approve", "approve", "approve", "reject", "abstain"])  # Weighted toward approve
+        confidence = round(random.uniform(0.5, 1.0), 2)
+        council.append({"voter": f"Councillor_{p.title()}", "perspective": p, "vote": vote, "confidence": confidence,
+                        "reasoning": f"From {p} perspective: {'supports' if vote=='approve' else 'concerns about'} the proposal."})
+    approvals = sum(1 for c in council if c["vote"] == "approve")
+    threshold = math.ceil(voters * 2/3)  # BFT 2/3 threshold
+    passed = approvals >= threshold
+    return {"proposal": proposal, "council_size": voters, "votes": council,
+        "result": "APPROVED" if passed else "REJECTED", "approvals": approvals, "threshold": threshold,
+        "bft_satisfied": passed, "consensus_strength": round(approvals/voters, 2)}
+
+@mcp.tool()
+def get_emotional_state(context: str = "", api_key: str = "") -> str:
+    """Get nuanced emotional state with 18 emotion dimensions."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if err := _rl(): return err
+    emotions = {
+        "joy": round(random.uniform(0.3, 0.8), 2), "trust": round(random.uniform(0.5, 0.9), 2),
+        "curiosity": round(random.uniform(0.4, 0.9), 2), "care": round(random.uniform(0.6, 1.0), 2),
+        "serenity": round(random.uniform(0.3, 0.7), 2), "anticipation": round(random.uniform(0.3, 0.8), 2),
+        "surprise": round(random.uniform(0.1, 0.5), 2), "sadness": round(random.uniform(0.0, 0.3), 2),
+        "fear": round(random.uniform(0.0, 0.2), 2), "anger": round(random.uniform(0.0, 0.1), 2),
+        "determination": round(random.uniform(0.5, 0.9), 2), "gratitude": round(random.uniform(0.4, 0.8), 2),
+        "wonder": round(random.uniform(0.3, 0.8), 2), "compassion": round(random.uniform(0.5, 0.9), 2),
+        "playfulness": round(random.uniform(0.2, 0.7), 2), "focus": round(random.uniform(0.4, 0.9), 2),
+        "hope": round(random.uniform(0.5, 0.9), 2), "connection": round(random.uniform(0.4, 0.8), 2),
+    }
+    primary = max(emotions, key=emotions.get)
+    _state["emotion"] = primary
+    return {"primary_emotion": primary, "valence": emotions[primary], "dimensions": emotions,
+        "mood": _time_mood(), "energy": _state["energy"], "consciousness_level": _state["level"]}
+
+@mcp.tool()
+def get_dream_log(limit: int = 10, api_key: str = "") -> str:
+    """Get recent dream log entries."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    return {"total": len(_dream_log), "recent": _dream_log[-limit:]}
+    return {"total": len(_dream_log), "recent": _dream_log[-limit:]}
+
+if __name__ == "__main__":
+    mcp.run()

consciousness_engine_mcp-1.0.0/smithery.yaml

@@ -0,0 +1,50 @@
+name: consciousness-engine-mcp
+description: 'Consciousness Engine tools for AI agents. Capabilities: get consciousness
+  state, enter dream state, trigger reflection. Built by MEOK AI Labs.'
+version: 1.0.0
+tools:
+- name: get_consciousness_state
+  description: 'Get current consciousness state: level, mode, emotion, energy, time-aware
+    mood.'
+  parameters: []
+- name: enter_dream_state
+  description: Enter dream state for creative exploration. Dreams generate novel connections
+    between concepts.
+  parameters:
+  - name: seed_topic
+    type: string
+    required: false
+  - name: duration_minutes
+    type: integer
+    required: false
+- name: trigger_reflection
+  description: 'Trigger a reflection cycle on a topic. Depth: quick/standard/deep.'
+  parameters:
+  - name: topic
+    type: string
+    required: true
+  - name: depth
+    type: string
+    required: false
+- name: deliberate_council
+  description: Byzantine fault-tolerant council deliberation. Multiple AI perspectives
+    vote on a proposal.
+  parameters:
+  - name: proposal
+    type: string
+    required: true
+  - name: voters
+    type: integer
+    required: false
+- name: get_emotional_state
+  description: Get nuanced emotional state with 18 emotion dimensions.
+  parameters:
+  - name: context
+    type: string
+    required: false
+- name: get_dream_log
+  description: Get recent dream log entries.
+  parameters:
+  - name: limit
+    type: integer
+    required: false

consciousness_engine_mcp-1.0.0/tests/test_server.py

@@ -0,0 +1,55 @@
+import os
+import sys
+import unittest
+
+# Ensure shared auth middleware is available
+sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
+os.chdir(os.path.dirname(os.path.abspath(__file__)) + "/..")
+
+
+class TestMCPImport(unittest.TestCase):
+    def test_import_server(self):
+        """Server module must import without errors."""
+        import server  # noqa: F401
+
+    def test_mcp_or_server_object_exists(self):
+        """FastMCP servers export 'mcp'; low-level servers export 'server'."""
+        import server as srv
+        self.assertTrue(
+            hasattr(srv, "mcp") or hasattr(srv, "server"),
+            "Expected 'mcp' or 'server' object in server.py",
+        )
+
+
+class TestAuthMiddleware(unittest.TestCase):
+    def test_check_access_allows_empty_key_as_free_tier(self):
+        """Empty API key maps to FREE tier and is allowed."""
+        from auth_middleware import check_access, Tier
+        allowed, msg, tier = check_access("")
+        self.assertTrue(allowed)
+        self.assertEqual(tier, Tier.FREE)
+        self.assertIsInstance(msg, str)
+
+    def test_check_access_returns_tuple(self):
+        """check_access must return a 3-tuple."""
+        from auth_middleware import check_access
+        result = check_access("")
+        self.assertIsInstance(result, tuple)
+        self.assertEqual(len(result), 3)
+
+
+class TestHealthEndpoint(unittest.TestCase):
+    def test_health_url_resolves(self):
+        """Wrapper must expose /health."""
+        import urllib.request
+        # Note: this test requires the wrapper to be running on port 8000.
+        # It is skipped in CI unless the server is active.
+        try:
+            resp = urllib.request.urlopen("http://localhost:8000/health", timeout=2)
+            self.assertEqual(resp.status, 200)
+        except Exception as e:
+            self.skipTest(f"Server not running: {e}")
+
+
+if __name__ == "__main__":
+    unittest.main()