Serveur MCP de Géocodage BAN

Ce serveur MCP permet de géocoder des adresses françaises via l'API de la Base Adresse Nationale (BAN).

Installation rapide

# Installer pyenv et UV
brew install pyenv uv  # macOS
# ou curl https://pyenv.run | bash && curl -LsSf https://astral.sh/uv/install.sh | sh

# Créer le projet
mkdir geocode-ban-mcp && cd geocode-ban-mcp
pyenv install 3.12.7 && pyenv local 3.12.7
uv init

# Installer les dépendances
uv add mcp requests

Installation avec docker

# Construire l'image
docker build -t geocode-ban-mcp .

# Lancer le conteneur
docker run -i geocode-ban-mcp

# Ou avec Docker pour Claude Desktop
# Dans claude_desktop_config.json :

Structure du projet

geocode-ban-mcp/
├── geocode_ban_mcp/
│   ├── __init__.py
│   └── server.py          # Code du serveur MCP
├── test_geocode.py        # Tests
├── pyproject.toml         # Configuration
└── README.md

Configuration Claude Desktop

Éditez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) :

Configuration avec avec uv

{
  "mcpServers": {
    "geocode-ban": {
      "command": "uvx",
      "args": [
        "--directory",
        "/chemin/absolu/vers/geocode-ban-mcp",
        "geocode-ban-mcp"
      ]
    }
  }
}

Configuration avec Docker

{
  "mcpServers": {
    "geocode-ban": {
      "command": "docker",
      "args": ["run", "-i", "geocode-ban-mcp"]
    }
  }
}

Redémarrez Claude Desktop. (nécessaire!!)

Tester

# Lancer les tests
uv run python test_geocode.py

Lancer le serveur en local

# Lancer les tests
uv run python -m geocode_ban_mcp.server

Utilisation dans Claude

Prompt

Géocode l'adresse 26 avenue André Morizet, Boulogne-Billancourt

Résultats

Je vais géocoder cette adresse pour vous.Voici les résultats du géocodage pour 26 avenue André Morizet, Boulogne-Billancourt :

📍 Adresse standardisée : 26 Avenue André Morizet 92100 Boulogne-Billancourt

📌 Coordonnées GPS :

• Latitude : 48.8357
• Longitude : 2.240435

🗺️ Liens de visualisation :

• Google Maps
• OpenStreetMap

🔗 Ressources

• API BAN
• Documentation MCP
• Documentation UV