Локальный MCP-клиент
  -> stdio
  -> blocksnet_mcp.server
  -> tools_mcp.analyze_urban_question
  -> BlocksNetAgent.run(question)
  -> serialize.to_json(result)
  -> JSON-ответ MCP-клиенту

blocksnet-mcp/
├── README.md
├── .env.example
├── .gitignore
├── requirements.txt
├── .python310/          # локальный Python 3.10.11, gitignored
├── .venv/               # локальное окружение Python 3.10.11, gitignored
├── docs/
│   ├── README.md
│   ├── WIKI-LLM.md
│   ├── overview_and_concept.md
│   ├── architecture.md
│   ├── tool_contract.md
│   ├── deployment.md
│   ├── mcp_repository_plan.md
│   ├── mas_integration_reference.md    # 🕘 Future-справка, gitignored
│   └── mas_registration.md             # 🕘 Future-справка, gitignored
├── blocksnet_mcp/
│   ├── README.md
│   ├── server.py
│   ├── tools_mcp.py
│   ├── serialize.py
│   ├── settings.py
│   └── __init__.py
├── blocksnet_agent/
│   ├── README.md
│   └── ... ядро агента из blocksnet-agent (agent.py / hypotheses.py / metrics.py / tools/...)
├── data/
│   ├── README.md                 # опц., локальный индекс
│   ├── service_type.json
│   ├── archetypes.csv
│   ├── service_aliases.json
│   ├── blocks_with_services.gpkg         # gitignored
│   ├── acc_mx.pickle                     # gitignored
│   └── <local-city-sandbox>/             # gitignored (например, saint_petersburg/)
├── tests/
│   ├── README.md
│   ├── test_serialize.py
│   ├── test_tool_contract.py
│   ├── test_async_mcp_contract.py
│   ├── test_confidence_signals.py
│   ├── test_overlay_candidates.py
│   ├── test_ptr_classifier.py
│   ├── test_runtime.py
│   ├── test_provision_cache.py
│   ├── test_numeric_metric_resolution.py
│   ├── test_provision_summaries.py
│   ├── test_target_block_selection.py
│   ├── test_tool_failure_dedup.py
│   ├── test_no_data_grounding.py
│   └── test_experiment_harness.py
├── scripts/
│   ├── README.md
│   └── smoke_client.py
├── examples/
│   ├── README.md
│   ├── test_visualization.ipynb
│   ├── saint_petersburg/main.py
│   ├── saint_petersburg/data/            # gitignored
│   └── yuzhno-sakhalinsk/                # gitignored
├── docs/
│   ├── reports/
│   │   ├── test_report_20260618.md
│   │   └── run_quality_report_20260706_spb.md
│   ├── mcp_repository_plan.md    # 🕘 локальный план, gitignored
│   ├── mas_integration_reference.md    # 🕘 Future-справка, gitignored
│   └── mas_registration.md             # 🕘 Future-справка, gitignored
└── outputs/             # runtime-артефакты, gitignored

{
  "question": "...",
  "analysis_plan": "...",
  "result": "...",
  "reflection": "...",
  "recommendations": [
    { "block_id": 4940, "service_type": "school", "added_capacity": null, "rationale": "..." }
  ],
  "measured_effects": [
    { "service_type": "pitch", "strong_before": 0.732, "strong_after": 0.781,
      "missing_before": 785, "missing_after": 769, "source": "compute_scenario_provision" }
  ],
  "recommendation_blocks": [4940],
  "confidence": 0.55,
  "confidence_self": 0.78,
  "confidence_basis": ["hypotheses=2/2_supported*0.25=+0.25", "data_basis=1.0*0.30=+0.30"],
  "overlay_candidates": [...],
  "overlay_meta": { "hard_passed": 5, "hard_total": 5, "diagnostic_layers": 1, "nondiagnostic_layers": 0 },
  "limitations": ["..."],
  "artifacts": ["maps/provision.png", "scenario.csv"],
  "run_id": "run_20260706_...",
  "run_dir": "outputs/run_20260706_...",
  "status": "ok",            // "ok" | "partial" | "failed"
  "salvaged": false
}

.\.venv\Scripts\python.exe -m pytest tests
.\.venv\Scripts\python.exe scripts\smoke_client.py
.\.venv\Scripts\python.exe -m blocksnet_mcp.server

CHAT_URL=https://ollama.com/v1
API_KEY=your_ollama_cloud_api_key_here
MODEL=minimax-m3:cloud
DATA_DIR=./data
OUTPUT_DIR=./outputs
MAX_ITERATIONS=10

{
  "mcpServers": {
    "blocksnet": {
      "command": "P:/AI_asistent/ITMO/blocksnet-mcp/.venv/Scripts/python.exe",
      "args": ["-m", "blocksnet_mcp.server"],
      "cwd": "P:/AI_asistent/ITMO/blocksnet-mcp",
      "env": {
        "CHAT_URL": "https://ollama.com/v1",
        "API_KEY": "your_ollama_cloud_api_key_here",
        "MODEL": "minimax-m3:cloud",
        "DATA_DIR": "./data",
        "OUTPUT_DIR": "./outputs",
        "MAX_ITERATIONS": "10"
      }
    }
  }
}