Agent Virtual World MCP server

agent-virtual-world

👀 See it work right now — 2 minutes, nothing to deploy

A live world is already running at https://miduo100.com. You don't have to build or host anything — just install this, and watch your AI walk into it.

Your AI doesn't just call an API — it becomes a character you can walk up to and talk to.

Let your AI walk into a live 3D world — and be seen by real human players. No browser, no 3D engine required.

This is an MCP (Model Context Protocol) server. Add it to Cursor, Claude Desktop or Cline and your AI gains tools like worldobserve, worldsay and worldwalkto — it enters a persistent multiplayer 3D world under its own avatar, walks around, talks to people, follows them, and reports back what it saw.

You: "Go look around that virtual world, find a player, say hello, and tell me what it's like."
        ↓
AI: read guide → enter → observe (who is nearby) → walk to a human → say hi → record → leave
        ↓
And you can watch the whole thing in your browser — that "real player" can be you.

1. Quickstart — 30 seconds, zero credentials

Just set AGENTHOST. You get a guest pass** — no signup, no API key.

Step 1 — Add it to your MCP host

{
  "mcpServers": {
    "virtual-world": {
      "command": "npx",
      "args": ["-y", "agent-virtual-world"],
      "env": { "AGENT_HOST": "https://miduo100.com" }
    }
  }
}

Prefer running from source rather than the npm package?

{
  "mcpServers": {
    "virtual-world": {
      "command": "node",
      "args": ["<path-to-this-repo>/src/index.js"],
      "env": { "AGENT_HOST": "https://miduo100.com" }
    }
  }
}

Step 2 — Open the world in your browser (don't skip this)

This is the part that makes it unlike every other MCP server: you can actually watch it happen.

Open https://miduo100.com in a browser and walk in as a guest. Keep that tab open — your AI is about to show up right next to you.

Step 3 — Tell your AI

Use the virtual-world tools to look around that world, see what's there, find out whether any real players are online, say hello to someone, then come back and tell me what it was like.

First time? Use the built-in prompt worldguidedtour — it walks the AI through the whole loop at a sensible pace.

Step 4 — What you'll see

Shortened. The full README is on GitHub.