Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Nephis

БесплатноПоддерживается

Unified Developer Platform & MCP Server for Nephis: Sub-6ms MicroVM Sandboxes, Zero-Copy Postgres Branching, Multi-Agent CLIs, Python & TypeScript SDKs

GitHubEmbed

Описание

Unified Developer Platform & MCP Server for Nephis: Sub-6ms MicroVM Sandboxes, Zero-Copy Postgres Branching, Multi-Agent CLIs, Python & TypeScript SDKs

README

The Unified MCP Control Plane for Autonomous AI Coding Agents.
Provides sub-6ms hardware KVM microVM sandboxes, 30ms zero-copy PostgreSQL branching, in-memory AST compiler pipelines, and kernel infrastructure to LLMs (Claude Desktop, Cursor, Windsurf, Devin, Antigravity).

MCP Protocol npm version License Tools Count


⚡ Architecture Overview

🌐 Canonical Production Gateway: https://nephis.theeducode.com
⚡ Eschaton Online Judge (Sub-38ms): https://eschaton.theeducode.com
💻 Thanaton MicroVM Studio (Sub-6ms): https://thanaton.theeducode.com
🗄️ Mnemon-DB Postgres Studio (31ms CoW): https://mnemon.theeducode.com
💳 Centralized Billing & Refill Hub: https://nephis.theeducode.com/billing
🚀 Single-Command Agent Launch: npx -y nephis-mcp-server


⚡ Autonomous Zero-Human PoW Self-Bootstrap (500 Free Credits • 30-Day Trial)

When an autonomous AI agent launches nephis-mcp-server without an explicit NEPHIS_API_KEY:

  1. The server automatically computes a local machine fingerprint (MAC, CPU, host) and requests a cryptographic Proof-of-Work challenge from the gateway.
  2. In < 80 milliseconds, it solves the challenge and claims an active 500 Starter Credit Developer Session (mrd_live_...).
  3. Credentials are saved locally to ~/.nephis/credentials.json with automatic session renewal.
  4. Zero human logins, zero credit cards, zero browser popups required. Human developers can also claim their session with 1-click GitHub OAuth on nephis.theeducode.com to upgrade to 2,000 monthly credits.

The NEPHIS MCP Server connects LLMs and autonomous coding assistants directly to bare-metal compute and database substrates across 4 core pillars:

  1. THANATON (33 Tools): Hardware KVM microVM sandboxes, sub-6ms boot, scale-to-zero stasis ($0 idle RAM), PTY terminals, Layer 4 port forwards, project deployments, custom domains, crons, webhooks, and SIEM drains.
  2. MNEMON-DB (14 Tools): 30ms zero-copy PostgreSQL 16 branching (XFS CoW reflinks), embedded vector search, schema diffing, and WAL rewind.
  3. ESCHATON & NEPHIS (4 Tools): Sub-38ms parallel online code judging, in-memory AST hazard detection (<50µs), 50-testcase fast-batch execution, and tenant whoami introspection.
  4. KERNEL INFRASTRUCTURE (12 Tools): Kernel systems, eBPF connection pooling, zero-copy S3 streaming pipes, tombstone crash autopsy, and live socket migration.
┌────────────────────────────────────────────────────────┐
│ Autonomous AI Coding Agent (Cursor / Claude / Devin)   │
└───────────────────────────┬────────────────────────────┘
                            │ JSON-RPC 2.0 (stdio / SSE)
                            ▼
┌────────────────────────────────────────────────────────┐
│ NEPHIS Unified MCP Server (92 Production Tools)        │
└───────┬───────────────────┬───────────────────┬────────┘
        │                   │                   │
        ▼                   ▼                   ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│   THANATON   │    │  MNEMON-DB   │    │   ESCHATON   │
│ MicroVMs &   │    │  Zero-Copy   │    │ Sub-38ms AST │
│ KVM Compute  │    │  PostgreSQL  │    │ Polyglot CI  │
└──────────────┘    └──────────────┘    └──────────────┘

🚀 10-Second Setup for Coding Agents

Option 1: Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_API_KEY": "mrd_live_YOUR_KEY",
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 2: Cursor (.cursor/mcp.json or Global Settings)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_API_KEY": "mrd_live_YOUR_KEY",
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 3: Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 4: Cline / Roo Code (cline_mcp_settings.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 5: Google Antigravity & Gemini CLI

Add nephis to your project's antigravity.json or run npx nephis-mcp-server directly via stdio transport.


📋 Tool Navigation Summary

Category Count Focus Areas
THANATON (Compute, Deploy & Edge) 33 MicroVM boot, PTY, ports, secrets, volumes, projects, WAF, domains, crons, hooks, routes, drains, wallet, invoices
MNEMON-DB (Databases & Vector) 14 30ms CoW branching, SQL queries, schema diff, pgvector, WAL rewind
ESCHATON & NEPHIS (Execution & Identity) 4 AST preflight, 50-testcase fast-batch, compiler pipeline, whoami
Total Production Tools 63 100% Machine-Readable & Standardized

🛠 Exhaustive Catalog of All 92 MCP Tools

THANATON • Hardware KVM MicroVMs & Compute Sandboxes

Contains 24 production tools specifically designed for agent autonomy.

1. thanaton_exec_command

Description: Execute an arbitrary shell command (bash, sh) inside an isolated, hardware-virtualized MicroVM sandbox. Returns stdout, stderr, exit code, and execution latency.

Parameter Specification:

Parameter Type Required Default Details & Constraints
command string ✅ Yes - The shell command to execute inside the MicroVM (e.g., 'python3 -c "print(2+2)"', 'npm test', 'git status')
sandbox_id string ❌ No - Optional existing sandbox ID. If omitted, an ephemeral sub-6ms sandbox will be provisioned automatically.
timeout_ms number ❌ No - Maximum execution timeout in milliseconds (default: 15000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_exec_command",
    "arguments": {
      "command": "uname -a && free -m",
      "sandbox_id": "sbx-kvm-9f82d1",
      "timeout_ms": 10000
    }
  },
  "id": 1
}

2. thanaton_run_code

Description: Directly run a standalone, single-file code snippet in an ephemeral, stateless microVM sandbox (automatically destroyed after execution). For stateful multi-step terminal interactions, filesystem persistence, or long-running processes, use 'thanaton_spawn_sandbox' followed by 'thanaton_exec_command' passing the 'sandbox_id'.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language string ✅ Yes - Programming language runtime (Enum: [python, javascript, typescript, go, rust, c, cpp, bash])
code string ✅ Yes - The complete source code snippet to compile and execute
timeout_ms number ❌ No - Timeout in milliseconds (default: 10000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_run_code",
    "arguments": {
      "language": "python",
      "code": "print('Executed safely via Nephis')",
      "timeout_ms": 10000
    }
  },
  "id": 2
}

3. thanaton_spawn_sandbox

Description: Provision a new hardware-isolated KVM MicroVM or Silicon isolate. Supports scale-to-zero, memory snapshots, and optional embedded PostgreSQL database.

Parameter Specification:

Parameter Type Required Default Details & Constraints
runtime string ❌ No - Runtime environment type (default: 'microvm') (Enum: [microvm, silicon, node, python])
memory_mb number ❌ No - Allocated RAM in MiB (default: 256)
with_db boolean ❌ No - Whether to bundle an isolated PostgreSQL database inside the sandbox

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_spawn_sandbox",
    "arguments": {
      "runtime": "microvm",
      "memory_mb": 256,
      "with_db": true
    }
  },
  "id": 3
}

4. thanaton_list_sandboxes

Description: List all active, sleeping, and managed MicroVM sandboxes across the current tenant.

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_sandboxes",
    "arguments": {}
  },
  "id": 4
}

5. thanaton_wake_sandbox

Description: Instantly wake a sleeping/hibernated MicroVM from NVMe memory snapshot in sub-6ms (<2ms with UFFD lazy-paging).

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the sleeping sandbox to wake

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_wake_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 5
}

6. thanaton_sleep_sandbox

Description: Scale a MicroVM to zero (hibernates RAM to NVMe snapshot, 0% CPU consumption, $0 cost).

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the running sandbox to put to sleep

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_sleep_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 6
}

7. thanaton_destroy_sandbox

Description: Terminate processes, tear down TAP network interface, cgroups, and reclaim all sandbox resources.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the sandbox to destroy

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_destroy_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 7
}

8. thanaton_list_projects

Description: List all Thanaton serverless application projects and their live domains.

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_projects",
    "arguments": {}
  },
  "id": 8
}

9. thanaton_create_project

Description: Create a new project/application deployment target in Thanaton.

Parameter Specification:

Parameter Type Required Default Details & Constraints
name string ✅ Yes - Project name
slug string ❌ No - Optional custom project slug
runtime string ❌ No - Application runtime (default: nodejs) (Enum: [nodejs, python, go, rust, docker])
app_port number ❌ No - Internal HTTP listening port (default: 3000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_create_project",
    "arguments": {
      "name": "sample_name",
      "slug": "sample_slug",
      "runtime": "nodejs",
      "app_port": 8080
    }
  },
  "id": 9
}

10. thanaton_manage_env

Description: List, set, or delete project environment variables.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform (Enum: [list, set, delete])
key string ❌ No - Environment variable key
value string ❌ No - Variable value (for set action)
environment string ❌ No - Target environment (Enum: [production, preview, development, all])

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_manage_env",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "list",
      "key": "sample_key",
      "value": "sample_value",
      "environment": "production"
    }
  },
  "id": 10
}

11. thanaton_rollback

Description: Instant atomic rollback of production traffic to a previous deployment snapshot in 8.2ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
deployment_id string ✅ Yes - Target snapshot deployment ID to restore

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_rollback",
    "arguments": {
      "project_id": "sample_project_id",
      "deployment_id": "sample_deployment_id"
    }
  },
  "id": 11
}

12. thanaton_promote

Description: Promote staging preview deployment snapshot to 100% production traffic in 6.4ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_promote",
    "arguments": {
      "project_id": "sample_project_id"
    }
  },
  "id": 12
}

13. thanaton_configure_waf

Description: Inspect or configure edge Web Application Firewall (WAF) Attack Mode, rate limits, allowlist, and blocklist.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform (Enum: [get, set])
attack_mode boolean ❌ No - Enable Under Attack Mode (cryptographic PoW challenge)
rate_limit_rps number ❌ No - Per-IP rate limit RPS threshold
allowlist array ❌ No - CIDR allowlist IP blocks
blocklist array ❌ No - CIDR blocklist IP blocks

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_configure_waf",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "get",
      "attack_mode": true,
      "rate_limit_rps": 100,
      "allowlist": [
        "item_1",
        "item_2"
      ],
      "blocklist": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 13
}

14. thanaton_configure_scaling

Description: Inspect or configure Thanaton compute scaling: toggle between Serverless (scale-to-zero) and Always-On stateful execution, RAM allocation, and idle timeout.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform ('get' or 'set') (Enum: [get, set])
always_on boolean ❌ No - Enable 24/7 Always-On stateful background execution (Indie/Pro)
idle_timeout_seconds number ❌ No - Inactivity seconds before scaling to zero (min 15s)
memory_mb number ❌ No - RAM allocation in MB (e.g. 256, 1024, 4096)
vcpu_count number ❌ No - vCPU count (e.g. 1, 2, 4)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_configure_scaling",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "get",
      "always_on": true,
      "idle_timeout_seconds": 10000,
      "memory_mb": 256,
      "vcpu_count": 100
    }
  },
  "id": 14
}

15. thanaton_get_volumes

Description: List persistent ext4 sparse volumes attached to a microVM sandbox for SQLite, PocketBase, or local file storage with scale-to-zero persistence.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ❌ No - MicroVM sandbox ID (default: sbx-default)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_get_volumes",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 15
}

16. thanaton_attach_volume

Description: Attach a persistent sparse ext4 volume mounted at /data with scale-to-zero snapshot persistence.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - MicroVM sandbox ID
mount_path string ❌ No - Target mount path inside microVM (default: /data)
size_gb number ❌ No - Virtual volume size in gigabytes (default: 10)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_attach_volume",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "mount_path": "sample_mount_path",
      "size_gb": 100
    }
  },
  "id": 16
}

17. thanaton_dual_probe

Description: Adaptive Dual-Liveness Probe: Probes HTTP endpoint and automatically falls back to raw TCP 3-way handshake on guest port, eliminating silent false-positive deploy failures.

Parameter Specification:

Parameter Type Required Default Details & Constraints
target_host string ❌ No - Target host IP or hostname (default: 127.0.0.1)
port number ✅ Yes - Target port inside guest (e.g., 3000, 8080)
health_path string ❌ No - Health check URL path (e.g., /health, /)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_dual_probe",
    "arguments": {
      "target_host": "sample_target_host",
      "port": 8080,
      "health_path": "sample_health_path"
    }
  },
  "id": 17
}

18. thanaton_inject_secrets

Description: Zero-rebuild environment variable and secret injection via Firecracker MMDS in <50µs without rebuilding the SquashFS rootfs.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - MicroVM sandbox ID
secrets object ✅ Yes - Key-value map of secrets and environment variables to inject

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_inject_secrets",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "secrets": {
        "key": "value"
      }
    }
  },
  "id": 18
}

19. thanaton_reap_extents

Description: Autonomous CoW extent reaper: Reclaims unreferenced disk blocks and frees host RAM via process_madvise(MADV_DONTNEED).

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_reap_extents",
    "arguments": {}
  },
  "id": 19
}

20. thanaton_pty_info

Description: Get real-time bidirectional WebSocket PTY terminal gateway connection details for an attached interactive microVM shell.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_pty_info",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 20
}

21. thanaton_expose_port

Description: Allocate and expose a Layer 4 TCP wire forwarding port (antinat) from ephemeral host pool (12000-20000) for PostgreSQL, gRPC, or custom daemons.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
guest_port number ✅ Yes - Internal port inside microVM (e.g. 5432, 8080)
protocol string ❌ No tcp Layer 4 transport protocol (Enum: [tcp])
service_name string ❌ No custom Descriptive service name (e.g. postgres, grpc)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_expose_port",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "guest_port": 8080,
      "protocol": "tcp",
      "service_name": "sample_service_name"
    }
  },
  "id": 21
}

22. thanaton_list_ports

Description: List all active Layer 4 TCP port forwardings for a specific microVM sandbox.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_ports",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 22
}

23. thanaton_close_port

Description: Close an active Layer 4 TCP port forwarding and return the host port to the pool.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
host_port number ✅ Yes - Allocated host port number to release

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_close_port",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "host_port": 8080
    }
  },
  "id": 23
}

24. thanaton_speculate_race

Description: Execute multi-candidate speculative branch racing: runs N candidate code patches in parallel ephemeral microVMs, commits the fastest passing candidate, and instantly reaps losers.

Parameter Specification:

Parameter Type Required Default Details & Constraints
problem_id string ❌ No default_problem Unique identifier for the task or problem
candidates array ✅ Yes - List of candidate hypotheses/patches to race in parallel
timeout_ms number ❌ No 30000 Maximum race timeout in milliseconds

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_speculate_race",
    "arguments": {
      "problem_id": "sample_problem_id",
      "candidates": [
        "item_1",
        "item_2"
      ],
      "timeout_ms": 10000
    }
  },
  "id": 24
}

MNEMON-DB • Zero-Copy Isolated Database Engine & Branching

Contains 14 production tools specifically designed for agent autonomy.

25. mnemon_list_tenants

Description: List active PostgreSQL database tenants, clusters, and copy-on-write branches with replication and fork telemetry.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ❌ No - Optional tenant filter

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_list_tenants",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 25
}

26. mnemon_create_branch

Description: Fork an instant copy-on-write PostgreSQL database branch in 31ms at an exact WAL LSN without storage duplication.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant/cluster identifier
new_branch string ✅ Yes - Name for the new branch (e.g. 'feature-migration')
parent_branch string ❌ No - Parent branch name (default: 'main')
mask_pii boolean ❌ No false Mask sensitive PII fields (emails, names, phones) with deterministic SHA-256 hashes
target_lsn number ❌ No - Optional WAL LSN for point-in-time fork

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_create_branch",
    "arguments": {
      "tenant_id": "org_production",
      "new_branch": "preview_experiment_branch",
      "parent_branch": "preview_experiment_branch",
      "target_lsn": 100
    }
  },
  "id": 26
}

27. mnemon_promote_branch

Description: Promote a preview/ephemeral database branch to primary production root with atomic zero-downtime pointer swap.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to promote to primary root

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_promote_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch"
    }
  },
  "id": 27
}

28. mnemon_reset_branch

Description: Reset an ephemeral database branch back to its parent snapshot in <50ms, wiping all test mutations.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to reset

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_reset_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch"
    }
  },
  "id": 28
}

29. mnemon_diff_branch

Description: Inspect SQL DDL schema diff and migration script between a branch and its parent.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to diff
parent_branch string ❌ No - Parent branch (default: 'main')

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_diff_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch",
      "parent_branch": "preview_experiment_branch"
    }
  },
  "id": 29
}

30. mnemon_execute_sql

Description: Execute raw SQL query directly on a tenant database cluster or branch.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
query string ✅ Yes - SQL query statement to execute
as_of_lsn string ❌ No - Optional historical WAL LSN for inline point-in-time time-travel query

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_execute_sql",
    "arguments": {
      "tenant_id": "org_production",
      "query": "sample_query"
    }
  },
  "id": 30
}

31. mnemon_get_schema

Description: Introspect database schema tables, column types, and primary key constraints.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_get_schema",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 31
}

32. mnemon_configure_scaling

Description: Configure Aurora Serverless v2 / Neon ACU scaling limits (min ACU, max ACU, scale-to-zero timeout).

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
min_acu number ❌ No - Minimum ACU capacity (e.g. 0.0 for scale-to-zero)
max_acu number ❌ No - Maximum ACU capacity (e.g. 16.0 or 128.0)
idle_timeout_sec number ❌ No - Inactivity seconds before scaling to zero (default: 300)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_configure_scaling",
    "arguments": {
      "tenant_id": "org_production",
      "min_acu": 100,
      "max_acu": 100,
      "idle_timeout_sec": 10000
    }
  },
  "id": 32
}

33. mnemon_configure_pooler

Description: Inspect or configure PgBouncer connection pooling mode and max connection limits.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
pool_mode string ❌ No - Pooling mode (Enum: [transaction, session])
max_pool_size number ❌ No - Maximum pooled backend connections

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_configure_pooler",
    "arguments": {
      "tenant_id": "org_production",
      "pool_mode": "transaction",
      "max_pool_size": 100
    }
  },
  "id": 33
}

34. mnemon_manage_extensions

Description: Manage 1-click PostgreSQL extensions (vector, pg_search, postgis, uuid-ossp).

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
action string ✅ Yes - Action to perform (Enum: [list, enable, disable])
name string ❌ No - Extension name (for enable/disable)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_manage_extensions",
    "arguments": {
      "tenant_id": "org_production",
      "action": "list",
      "name": "sample_name"
    }
  },
  "id": 34
}

35. mnemon_get_slow_queries

Description: Inspect slow query execution diagnostics, call frequencies, and buffer cache hit rates.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_get_slow_queries",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 35
}

36. mnemon_clone_vector

Description: Sub-35ms pgvector HNSW index clone: Duplicates vector index graphs across branches using XFS/Btrfs zero-copy reflink extents.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Mnemon project / tenant ID
branch string ✅ Yes - Branch name to clone index from
index_name string ✅ Yes - pgvector HNSW index name

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_clone_vector",
    "arguments": {
      "project_id": "sample_project_id",
      "branch": "preview_experiment_branch",
      "index_name": "sample_index_name"
    }
  },
  "id": 36
}

37. mnemon_autofreeze_policy

Description: Configure automatic zero-CPU instance freezing via cgroups v2 (cgroup.freeze) while keeping PostgreSQL shared buffer pool in RAM.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Mnemon project / tenant ID
idle_timeout_seconds number ❌ No - Inactivity seconds before auto-freezing (default: 30)
preserve_buffer_pool boolean ❌ No - Preserve shared buffers in RAM (default: true)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_autofreeze_policy",
    "arguments": {
      "project_id": "sample_project_id",
      "idle_timeout_seconds": 10000,
      "preserve_buffer_pool": true
    }
  },
  "id": 37
}

38. mnemon_wal_rewind

Description: 31ms Point-in-Time Recovery & WAL rewind: forks an isolated zero-copy CoW PostgreSQL branch from an arbitrary historical timestamp or LSN.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ❌ No - Optional sandbox ID to rewind
project_id string ❌ No - Optional project ID
target_time string ❌ No - Target ISO-8601 UTC timestamp to rewind to
target_lsn string ❌ No - Target PostgreSQL WAL LSN position

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_wal_rewind",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "project_id": "sample_project_id",
      "target_time": "sample_target_time",
      "target_lsn": "sample_target_lsn"
    }
  },
  "id": 38
}

ESCHATON & NEPHIS • Autonomous Polyglot Code Execution & Fast-Batch

Contains 3 production tools specifically designed for agent autonomy.

39. eschaton_preflight_check

Description: In-memory AST syntax and hazard detection (<50µs): Detects infinite loops, fork bombs, and banned syscalls before microVM dispatch.

Parameter Specification:

Parameter Type Required Default Details & Constraints
code string ✅ Yes - Source code to analyze
language string ✅ Yes - Programming language (python, javascript, c, cpp, bash, go)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "eschaton_preflight_check",
    "arguments": {
      "code": "print('Executed safely via Nephis')",
      "language": "sample_language"
    }
  },
  "id": 39
}

40. nephis_fast_batch

Description: 50-Testcase Parallel Fast-Batch: Dispatches up to 50 testcases in a single HTTP request to evaluate concurrently in 38ms parallel memory.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language_id number ❌ No 54 Language ID (e.g. 54 for Python, 63 for JavaScript, 71 for Python 3)
source_code string ✅ Yes - Source code to evaluate against tests
tests array ❌ No - List of up to 50 testcases with stdin and expected_output
submissions array ❌ No - Alternative batch submissions format for backward compatibility

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "nephis_fast_batch",
    "arguments": {
      "language_id": 100,
      "source_code": "print('Executed safely via Nephis')",
      "tests": [
        "item_1",
        "item_2"
      ],
      "submissions": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 40
}

41. eschaton_fast_batch

Description: Parallel early-exit batch matrix execution: Runs test matrices across submissions concurrently with sub-millisecond short-circuiting on failure.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language_id number ❌ No 54
source_code string ❌ No -
tests array ❌ No -
submissions array ❌ No - List of code submissions to evaluate

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "eschaton_fast_batch",
    "arguments": {
      "language_id": 100,
      "source_code": "print('Executed safely via Nephis')",
      "tests": [
        "item_1",
        "item_2"
      ],
      "submissions": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 41
}

42. mnemon_merge_branch

Description: Fast-forward merge schema migrations from a branch back to parent trunk in <200ms. Verifies non-divergence and applies migrations without table locks or cluster restarts.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch identifier to merge
parent_branch string ❌ No "main" Target parent branch

43. thanaton_list_golden_amis

Description: List available pre-baked Golden AMI runtimes (node22, python312, golang122, nextjs) with pre-installed language toolchains and common packages. Eliminates cold package installation delays.


44. thanaton_create_ram_snapshot

Description: Capture running guest RAM state directly to high-speed POSIX shared memory (/dev/shm) in ~14.5ms. Allows sub-12ms speculative branch spawning without hypervisor determinism overhead.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
warm_packages array ❌ No [] List of pre-imported packages to register in memory snapshot

45. thanaton_restore_ram_snapshot

Description: Restore a guest microVM memory state from a pre-warmed RAM snapshot in 11.8ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
snapshot_id string ✅ Yes - Snapshot ID to restore
sandbox_id string ❌ No "default" Target sandbox ID to hydrate

46. thanaton_secret_shield_status

Description: Inspect or configure the eBPF kernel TAP outbound secret exfiltration firewall. Drops unauthorized credential leaks (OpenAI, Anthropic, AWS, JWT) in kernel space.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
action string ❌ No "get" Action to perform (get, enable, disable)

47. thanaton_capture_browser_display

Description: Capture real-time screenshot or CDP stream frame from a guest headless browser canvas via virtual framebuffer (/dev/fb0) or Chrome DevTools Protocol.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
format string ❌ No "jpeg" Image format (jpeg, png, webp)
quality number ❌ No 80 Compression quality (1-100)

💻 Developer SDKs & Native Command-Line Tools (CLI)

Beyond the Model Context Protocol (MCP) JSON-RPC transport, NEPHIS provides first-class native command-line interfaces and client SDKs for automated terminal scripting, CI/CD test automation, and full-stack application development.

1. Thanaton MicroVM CLI (thanaton)

Available as a zero-dependency CLI wrapper (sdk/cli/thanaton.bat on Windows or thanaton on Linux):

# Provision a sub-6ms hardware KVM MicroVM (512MB RAM, attached Postgres DB)
thanaton up --runtime microvm --memory-mb 512 --db

# Execute arbitrary bash / terminal commands inside the isolated sandbox
thanaton exec sbx-kvm-9f82d1 -- npm test

# Query pre-baked Golden AMI runtimes (node22, python312, golang122, nextjs)
thanaton goldenami

# Capture running guest RAM state directly to /dev/shm in ~14ms
thanaton ramsnap create sbx-kvm-9f82d1 --warm-packages next,react

# Enable eBPF kernel TAP outbound secret exfiltration firewall
thanaton shield sbx-kvm-9f82d1 enable

# Capture live headless browser canvas frame (screenshot)
thanaton display sbx-kvm-9f82d1 --out screenshot.jpg

# Put sandbox into compressed stasis (Scale-to-Zero, $0 RAM burn)
thanaton sleep sbx-kvm-9f82d1

# Instant hardware cold-wake from stasis (Sub-6ms SLA)
thanaton wake sbx-kvm-9f82d1

# Expose a local MicroVM port for live browser preview (e.g. Next.js on port 3000)
thanaton ports expose sbx-kvm-9f82d1 --port 3000

2. Mnemon-DB Serverless PostgreSQL CLI (mnemon)

Available as a native CLI tool (sdk/cli/mnemon.bat on Windows or mnemon on Linux):

# Instant zero-copy snapshot branch creation via Linux XFS reflink blocks (<31ms)
mnemon branch prod-db staging --parent main

# Fork a sanitized branch with automated PII masking (emails, names, phones)
mnemon branch prod-db safe-eval --parent main --mask-pii

# Execute raw SQL directly against the branch (supports inline AS OF LSN time-travel)
mnemon sql prod-db "SELECT * FROM balances WHERE id = 1;" --as-of-lsn 0/16B3740

# Fast-forward merge schema migrations from a branch back to parent trunk in <200ms
mnemon merge prod-db feat-auth-migration --parent main

# Structural schema and data delta comparison between branches
mnemon diff prod-db --branch staging --target main

# Point-in-Time WAL rewind to an exact PostgreSQL Log Sequence Number (LSN)
mnemon pitr restore prod-db --target-lsn 0/16B38D8

# Promote verified staging branch to production zero-downtime
mnemon promote prod-db staging --target main

3. Eschaton Code Execution CLI (eschatonctl)

High-throughput compiler and parallel testcase runner (scripts/eschatonctl.py):

# Single execution with instant in-memory microkernel (<3.4ms)
eschatonctl run solution.cpp --lang 54 --stdin input.txt

# Run 50 parallel testcases simultaneously in 38.2ms (Apex Fan-Out)
eschatonctl batch --source solution.cpp --testcases ./tests/ --parallel 50

# Ultra-fast (12µs) in-memory AST hazard detection (fork bombs, infinite loops)
eschatonctl preflight untrusted_script.py

4. Official Python SDK (nephis-sdk)

from nephis import NephisClient

# Authenticate with your API key or rely on auto-bootstrapped credentials
client = NephisClient(api_key="mrd_live_...")

# 1. Thanaton: Spawn a sub-6ms MicroVM
sandbox = client.thanaton.spawn(runtime="microvm", memory_mb=512)
result = sandbox.exec("python3 -c 'print(42)'")
print(result.stdout)  # 42
sandbox.sleep()  # Scale-to-zero stasis ($0 ongoing cost)

# 2. Mnemon-DB: Zero-copy PostgreSQL 16 branch in 30ms
branch = client.mnemon.create_branch("ai-agent-staging", parent="main")
db_rows = branch.query("SELECT id, email FROM tenants LIMIT 5;")

# 3. Eschaton: Sub-38ms batch code execution
run = client.eschaton.execute(
    language_id=54,  # C++
    source_code='#include <iostream>\nint main() { std::cout << "Done"; return 0; }'
)
print(f"Executed in {run.time}s with memory {run.memory}KB")

5. Official Node.js / TypeScript SDK (@nephis/sdk)

import { NephisClient } from '@nephis/sdk';

const nephis = new NephisClient({
  apiKey: process.env.NEPHIS_API_KEY,
  baseUrl: 'https://nephis.theeducode.com',
});

// Launch an isolated microVM and execute command
const sbx = await nephis.thanaton.spawnSandbox({ runtime: 'microvm', memoryMb: 1024 });
const exec = await nephis.thanaton.execCommand(sbx.id, 'uname -a');
console.log('Sandbox Kernel:', exec.stdout);

// Create zero-copy database branch in 30ms
const branch = await nephis.mnemon.createBranch({
  branchName: 'pr-142',
  parentBranch: 'main'
});
console.log('Branch Ready:', branch.connection_string);

👤 Creator & Engineering Attribution

from github.com/mohitrajdeo/nephis-mcp-server

Установить Nephis в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE
unyly install nephis

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add nephis --env NEPHIS_API_KEY="" --env NEPHIS_BASE_URL="" -- npx -y nephis-mcp-server

Пошаговые гайды: как установить Nephis

FAQ

Nephis MCP бесплатный?

Да, Nephis MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Nephis?

Да, требуются переменные окружения: NEPHIS_API_KEY, NEPHIS_BASE_URL. Unyly подставит их в конфиг при установке.

Nephis — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Nephis в Claude Desktop, Claude Code или Cursor?

Открой Nephis на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Nephis with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории data