# pylegifrance/mcp-server-legifrance architecture

> Architecture diagram of the GitHub repository pylegifrance/mcp-server-legifrance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pylegifrance/mcp-server-legifrance
- Repository: https://github.com/pylegifrance/mcp-server-legifrance

## Overview

This repository is a small MCP server that exposes Legifrance searches to compatible LLM clients. The principal workflow is a client invoking a registered search tool, the server dispatching the request to the corresponding Legifrance API endpoint, and returning the result as MCP text. It also exposes a predefined legal-expert prompt. The README documents the three search capabilities; the sampled source shows their dispatch and shared HTTP request handling, but not the full implementation details of every handler.

Main entry points: [`src/server.py`](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py) (Tool dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["MCP server"]
  node_entry["Server entry<br/>[server.py]"]
  node_tools["Tool registry<br/>[server.py]"]
  node_dispatch["Tool dispatch<br/>[server.py]"]
  node_prompt["Expert prompt<br/>[server.py]"]
end

subgraph group_search["Legal searches"]
  node_text_search["Legal text search<br/>[server.py]"]
  node_code_search["Code search<br/>[server.py]"]
  node_case_search["Case law search<br/>[server.py]"]
end

subgraph group_integration["External services"]
  node_api_request["API request<br/>[server.py]"]
  node_legifrance["Legifrance API"]
end

node_client(("MCP client"))

node_client -->|"connects to"| node_entry
node_entry -->|"registers tools"| node_tools
node_entry -->|"runs server"| node_dispatch
node_dispatch -->|"routes loda"| node_text_search
node_dispatch -->|"routes code"| node_code_search
node_dispatch -->|"routes juri"| node_case_search
node_dispatch -->|"calls"| node_api_request
node_api_request -->|"posts request"| node_legifrance

click node_entry "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_tools "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_dispatch "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_prompt "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_text_search "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_code_search "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_case_search "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"
click node_api_request "https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_tools,node_dispatch,node_prompt,node_client toneBlue
class node_text_search,node_code_search,node_case_search toneAmber
class node_api_request,node_legifrance toneMint
```

## Components

### MCP server

- [Server entry](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- [Tool registry](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- [Tool dispatch](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- [Expert prompt](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`

### Legal searches

- [Legal text search](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- [Code search](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- [Case law search](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`

### External services

- [API request](https://github.com/pylegifrance/mcp-server-legifrance/blob/main/src/server.py): `src/server.py`
- **Legifrance API**

### Other components

- **MCP client**

## Connections

- MCP client → Server entry: connects to (evidence: `README.md`)
- Server entry → Tool registry: registers tools (evidence: `src/server.py`)
- Server entry → Tool dispatch: runs server (evidence: `src/server.py`)
- Tool dispatch → Legal text search: routes loda (evidence: `src/server.py`)
- Tool dispatch → Code search: routes code (evidence: `src/server.py`)
- Tool dispatch → Case law search: routes juri (evidence: `src/server.py`)
- Tool dispatch → API request: calls (evidence: `src/server.py`)
- API request → Legifrance API: posts request (evidence: `src/server.py`)
