pip install -e ".[dev]"

{
  "mcpServers": {
    "nowhere": {
      "command": "python",
      "args": ["-m", "nowhere.server"],
      "cwd": "你的仓库路径"
    }
  }
}

python -m nowhere.playground

🌀 > open 北京
🌀 > walk N
🌀 > listen
🌀 > look
🌀 > ask 故宫
🌀 > walkto 天坛
🌀 > quit

python -m nowhere.server --web 8080

# 开门
curl -X POST http://localhost:8080/open_door -d '{"to": "北京"}'

# 走路
curl -X POST http://localhost:8080/walk -d '{"direction": "N", "distance_km": 2}'

# 听电台
curl -X POST http://localhost:8080/listen -d '{"seconds": 10}'

# 看看周围
curl -X POST http://localhost:8080/look_around

# 发问
curl -X POST http://localhost:8080/ask -d '{"topic": "故宫"}'

python -m nowhere.playground --web

import asyncio
from nowhere import server, state as state_mod

async def main():
    server._state = state_mod.WorldState()
    
    # 开门
    r = await server.open_door_impl(to='巴黎')
    print(r['text'])
    
    # 走路
    r = await server.walk_impl(direction='N', distance_km=2)
    print(r['text'])
    
    # 问问题
    r = await server.ask_impl(topic='埃菲尔铁塔')
    print(r['text'])

asyncio.run(main())

【中国,北京,上午,夏天。】鸽哨从头顶划过去，你抬头看，一群灰鸽子
在天上盘旋。哨声是嗡的，低的，像风穿过瓶口。鸽子绕了一圈又一圈，
哨声忽远忽近。你站在胡同里，脖子仰酸了。鸽子飞远了，哨声还挂在
天上，过了几秒才散。远处西北方,圆明园像一个还没讲完的故事。
人行道的砖缝里长了草。海拔 300 米。水泥地硬得像铁。
同时,收音机里有声音。安丘924(FM92.4),正放着综合。

git clone <repo-url>
cd nowhere
pip install -e ".[dev]"
python -m nowhere.playground        # 试玩
python -m nowhere.server --web 8080 # web + API

# SRTM 地形瓦片（~2GB，可选，按需拉取）
python tools/build_tiles.py

# GeoNames 全量地名（~2GB）
python tools/import_geonames.py

# 看看有多少城市可探索
wc -l nowhere/EXPLORABLE_PLACES.md

# 查看某个城市的内容层
python -c "import json; d=json.load(open('nowhere/data/explorable_index.json')); print(d['places'].get('北京', {}))"

nowhere/
  server.py      -- MCP 服务器，接 14 个工具
  terrain.py     -- 离线地形（SRTM 瓦片 + 海拔/地表/坡度）
  sky.py         -- 离线天空（太阳、月亮、银河、行星）
  weather.py     -- 天气（Open-Meteo / 气候区兜底）
  water.py       -- 海表温度 + 海洋生物
  hydrology.py   -- 水文特征（河流/湖泊/海岸线）
  soundscape.py  -- 声音景观（环境音 + 电台钩子）
  radio.py       -- 电台查找（离线兜底 + Radio-Browser API）
  life.py        -- 野生生物遇见（iNaturalist）
  art.py         -- 艺术品遇见（大都会博物馆）
  encounters.py  -- 区域遇见场景
  humanities.py  -- 人文层（事件/人物/作品，270+ 卡）
  localcolor.py  -- 地方特色（物产/声音/痕迹/美食/节律）
  baked.py       -- 食物 + 植物描述
  describe.py    -- 中文散文渲染器
  salience.py    -- 注意力排序（每步 top3）
  landing.py     -- 随机落点池（64 个世界级地标）
  country.py     -- 坐标→国家码
  geocode.py     -- 地名→坐标（离线优先）
  places.py      -- 地名数据库 + 补丁
  walk.py        -- 走路物理（坡度、悬崖、水域阻挡、语义方向）
  listen.py      -- 电台音频抓取与分析
  state.py       -- 可变世界状态（位置/路径/时间/明信片/纪念品）
  marks.py       -- 标记保存/加载
  placememory.py -- 落点记忆（来了几次、动物目击、明信片落盘）
  knowledge.py   -- 离线知识库 + ZIM 百科
  providers.py   -- HTTP 请求（超时、断路器、缓存）
  poster.py      -- 明信片海报生成
  playground.py  -- 命令行试玩模式
  web.py         -- 网页旁观 + HTTP API