Skip to content

Commit e9cbef2

Browse files
committed
feat: add life events support (list_life_events, get_life_event_details) with client scraping, enable Colly AllowURLRevisit, add tests and update README/copilot wording
1 parent 215c6df commit e9cbef2

File tree

7 files changed

+829
-4
lines changed

7 files changed

+829
-4
lines changed

.github/copilot-instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This is a Model Context Protocol (MCP) server written in Go that provides search
1111
- **CI/CD**: GitHub Actions workflows
1212

1313
Always use Context7 to use the latest best practices and versions.
14-
Generated Git Commit messages should follow conventional commits format (short 1 liner but explicit).
14+
Generated Git Copilot Commit messages should follow conventional commits format (short 1 liner but explicit).
1515
Documentation should be clear and concise and in the docs/ folder (as subfolders as needed).
1616

1717
## Core Functionality

README.md

Lines changed: 46 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,15 @@ A Model Context Protocol (MCP) server that provides search and retrieval capabil
44

55
## Description
66

7-
This MCP server enables AI assistants to search and retrieve official French administrative procedures and tax information. Built with Go and powered by intelligent web scraping, it provides six main capabilities:
7+
This MCP server enables AI assistants to search and retrieve official French administrative procedures and tax information. Built with Go and powered by intelligent web scraping, it provides eight main capabilities:
88

99
### Service-Public.gouv.fr Tools
1010

1111
- **search_procedures**: Find relevant public service procedures and articles
1212
- **get_article**: Retrieve complete information from specific service-public.gouv.fr articles
1313
- **list_categories**: Browse available categories of public service information
14+
- **list_life_events**: List all available life events (événements de vie) guides
15+
- **get_life_event_details**: Retrieve detailed information about specific life situations
1416

1517
### Impots.gouv.fr Tools
1618

@@ -237,7 +239,21 @@ After adding the configuration, restart Claude Desktop. The server will be avail
237239

238240
## Available Tools
239241

240-
The server provides six MCP tools across two domains:
242+
The server provides eight MCP tools across two domains:
243+
244+
### Which Tool Should I Use?
245+
246+
**For major life situations** (buying a house, getting married, having a baby, death, moving, retirement, etc.):
247+
- 🎯 **Start with `list_life_events`** - comprehensive guides organized by topic
248+
- Then use **`get_life_event_details`** with a URL to get all procedures
249+
250+
**For specific administrative procedures** (passport renewal, driver's license, etc.):
251+
- 🔍 **Use `search_procedures`** - targeted search for specific procedures
252+
- Then use **`get_article`** to get full details
253+
254+
**For tax information**:
255+
- 💰 **Use `search_impots`** for forms and tax procedures
256+
- Then use **`get_impots_article`** for detailed information
241257

242258
### Service-Public.gouv.fr Tools
243259

@@ -271,6 +287,34 @@ List available categories of public service information.
271287
**Output:**
272288
- `categories`: Array of available categories with name and description
273289

290+
#### 4. list_life_events
291+
292+
List all available life events (événements de vie) from the "Comment faire si" section of service-public.gouv.fr. These are comprehensive practical guides for major life situations like expecting a child, moving, retirement, etc.
293+
294+
**Output:**
295+
- `events`: Array of life events with title, URL, and description
296+
297+
**Example events:**
298+
- "J'attends un enfant" (Expecting a child)
299+
- "Je déménage en France" (Moving within France)
300+
- "Un proche est décédé" (Death of a loved one)
301+
- "Je prépare ma retraite" (Preparing for retirement)
302+
303+
#### 5. get_life_event_details
304+
305+
Retrieve detailed information about a specific life event, including all sections organized by topic (Health, Civil Status, Employment, etc.).
306+
307+
**Input:**
308+
- `url` (string): URL of the life event to retrieve (from list_life_events results)
309+
310+
**Output:**
311+
- `title`: Life event title
312+
- `url`: Life event URL
313+
- `introduction`: Overview text
314+
- `sections`: Array of detailed sections with title and content
315+
316+
**See also:** [Life Events Documentation](docs/LIFE_EVENTS.md)
317+
274318
### Impots.gouv.fr Tools
275319

276320
#### 4. search_impots

0 commit comments

Comments
 (0)