# 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

```bash
# 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 
```bash
# 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
```json
{
  "mcpServers": {
    "geocode-ban": {
      "command": "uvx",
      "args": [
        "--directory",
        "/chemin/absolu/vers/geocode-ban-mcp",
        "geocode-ban-mcp"
      ]
    }
  }
}
```

### Configuration avec Docker
```json
{
  "mcpServers": {
    "geocode-ban": {
      "command": "docker",
      "args": ["run", "-i", "geocode-ban-mcp"]
    }
  }
}
```

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

## Tester

```bash
# Lancer les tests
uv run python test_geocode.py
```

## Lancer le serveur en local
```bash
# 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](https://www.google.com/maps?q=48.8357,2.240435)
- [OpenStreetMap](https://www.openstreetmap.org/?mlat=48.8357&mlon=2.240435&zoom=17)


## 🔗 Ressources

- [API BAN](https://adresse.data.gouv.fr/api-doc/adresse)
- [Documentation MCP](https://modelcontextprotocol.io)
- [Documentation UV](https://docs.astral.sh/uv/)