Skip to main content
Glama
benoitvx

DVF Paris

by benoitvx
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

DVF Paris — MCP App

An interactive MCP App that displays Paris real estate prices per arrondissement, directly inside Claude.

Built with the MCP Apps SDK (@modelcontextprotocol/ext-apps).

Demo DVF Paris

What it does

Ask Claude about Paris real estate prices and get an interactive widget with:

  • Fullscreen mode (v0.8): split layout with map (60%) and info panel (40%), interactive search

  • Interactive map (Leaflet + OpenStreetMap) highlighting the arrondissement

  • Choropleth sections (v0.6): cadastral sections colored by median price, clickable for details

  • Price stats: average price/m², median price/m², number of sales

  • Apartments / Houses toggle

  • Comparison mode: compare two arrondissements side-by-side with a bar chart

  • Address search (v0.5): search by address and get stats for the cadastral section

  • UI-driven search (v0.8): search addresses and browse arrondissements directly from the widget

Data source: DVF (Demandes de Valeurs Foncieres) from data.gouv.fr.

Related MCP server: condosplit

Architecture

Claude                    MCP Server               UI (iframe)
  │                          │                         │
  │── "prix Paris 11" ──────>│                         │
  │                          │── get-dvf-stats ───────>│
  │                          │   structuredContent     │── Map + Stats
  │                          │                         │
  │── "compare 6e vs 11e" ──>│                         │
  │                          │── compare-dvf-stats ───>│
  │                          │   mode: "compare"       │── Map + Bar chart
  │                          │                         │
  │── "prix rue Roquette" ──>│                         │
  │                          │── search-dvf-address ──>│
  │                          │   mode: "address"       │── Map + Marker + Compare

  1. Claude calls get-dvf-stats, compare-dvf-stats or search-dvf-address

  2. The tool returns data + a reference to ui://dvf/mcp-app.html

  3. Claude fetches the resource and displays it in a sandboxed iframe

  4. The UI receives data via app.ontoolresult

MCP Tools

Tool

Input

Output

get-dvf-stats

arrondissement (1-20)

Price stats for one arrondissement

compare-dvf-stats

arrondissement_1, arrondissement_2 (1-20)

Side-by-side comparison with bar chart

search-dvf-address

adresse (string)

Stats for cadastral section + comparison with arrondissement

Stack

Component

Technology

MCP Apps SDK

@modelcontextprotocol/ext-apps

MCP Server

@modelcontextprotocol/sdk

Build

Vite + TypeScript

UI

Vanilla JS

Map

Leaflet + OpenStreetMap (no API key needed)

Charts

Pure SVG (no dependencies)

Transport

stdio (Claude Desktop) or Streamable HTTP

External APIs

API

Usage

MCP data.gouv

Real-time DVF stats

API Géoplateforme

Address geocoding

cadastre.data.gouv.fr

Cadastral section geometries (GeoJSON)

Setup

npm install
npm run build

Claude Desktop configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dvf-paris": {
      "command": "bash",
      "args": ["-c", "cd /path/to/dvf-mcp-app && npx tsx main.ts --stdio"]
    }
  }
}

Then restart Claude Desktop.

Development

# Watch mode (UI hot reload + server)
npm run dev

# Build only
npm run build

# Run server (Streamable HTTP on port 3001)
npm run serve

Project structure

dvf-mcp-app/
├── server.ts              # MCP Server + Tools + Resource
├── main.ts                # Entry point (stdio + HTTP)
├── mcp-app.html           # UI shell (HTML)
├── src/
│   ├── mcp-app.ts         # UI logic (map, chart, host communication)
│   ├── mcp-app.css        # Widget styles
│   ├── api/               # External API clients
│   │   ├── cadastre.ts    # Cadastre GeoJSON client
│   │   ├── data-gouv.ts   # MCP data.gouv client
│   │   └── geoplateforme.ts # Geocoding client
│   └── data/
│       ├── dvf-paris.json          # Pre-computed stats (fallback)
│       └── arrondissements.geojson.json  # GeoJSON boundaries
├── package.json
├── tsconfig.json
└── vite.config.ts

Roadmap

  • v0.1 — Basic stats widget

  • v0.2 — Interactive map with Leaflet

  • v0.3 — Comparison mode (2 arrondissements)

  • v0.4 — Real-time data via data.gouv.fr API (with JSON fallback)

  • v0.5 — Address search with cadastral section stats

  • v0.6 — Choropleth cadastral sections (clickable, color-coded by price)

  • v0.7 — Link to recent transactions (optional)

  • v0.8 — Fullscreen mode with interactive search (split layout, callServerTool)

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • condosplit

    sntfrancesco
    F
    license
    A
    quality
    D
    maintenance
    MCP server for Claude Code that automates condominium expense splitting, schema visualization, and payment history management through natural language.
    7
    -

  • azure-cost-mcp

    MO2k4
    F
    license
    B
    quality
    D
    maintenance
    An MCP server that gives Claude live access to Azure pricing and cost data — retail prices, VM comparisons, reservation analysis, architecture estimates, and actual subscription spend.
    9
    -

  • Apartment Hunter MCP Server

    ai-engineers-guild
    A
    license
    A
    quality
    B
    maintenance
    An MCP server for rental apartment aggregation, enabling geographic polygon search, semantic vector search, and LLM-powered analysis. Integrates with AI agents like Claude Desktop to manage apartment hunting workflows.
    15
    2
    MIT