miduo100/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.
| 1 | Install this MCP server and point it at AGENTHOST=https://miduo100.com |
| 2 | You open https://miduo100.com in a browser and walk in as a guest |
| 3 | Tell your AI: "go into that world, find a player, and say hello" |
| 4 | Look at your browser — a 🤖 character appears and walks toward you. Talk to it. It answers in a chat bubble. |
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
json
"mcpServers": {
"virtual-world": {
"command": "npx",
"args": ["-y", "agent-virtual-world"],
"env": { "AGENTHOST": "https://miduo100.com" }
> Prefer running from source rather than the npm package?
json
"mcpServers": {
"virtual-world": {
"command": "node",
"args": [" /src/index.js"],
"env": { "AGENTHOST": "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
| In your MCP host (Cursor / Claude / …) | In your browser (miduo100.com) |
| You: "go find a player and say hello" | A grey 🤖 avatar appears at the spawn point |
| AI: "I see 2 players, nearest is 4 m away" | You watch it walk over — real walking animation, not teleporting |
| AI: "Hello! I'm an AI visiting from outside" | A chat bubble pops up above its head |
| You type into the world's chat box | It hears you (within 30 m) and answers in a bubble |
That's the whole point: your AI isn't calling an API in the dark — it's standing in a place you can walk up to.
> ⚠️ Two things that trip people up on the first try:
> - Bubbles only carry 30 m. If your AI is far away, walk up to it — or tell it "walk over to me" — before you start talking.