Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port to listen on for HTTP server | 3000 |
| LOG_LEVEL | No | Logging level: error, warn, info, debug | info |
| HTTP_RETRIES | No | Maximum number of retry attempts | 3 |
| HTTP_TIMEOUT | No | HTTP request timeout in milliseconds | 30000 |
| MCP_ICON_URL | No | Absolute URL to icon - defaults to /icon.svg relative to server URL | /icon.svg |
| GALLICA_SRU_URL | No | SRU search endpoint | https://gallica.bnf.fr/SRU |
| GALLICA_BASE_URL | No | Base URL for Gallica API | https://gallica.bnf.fr |
| DEFAULT_MAX_RECORDS | No | Default maximum search results | 10 |
| DEFAULT_START_RECORD | No | Default starting record for pagination | 1 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_by_title | Search for documents in the Gallica digital library by title. |
| search_by_author | Search for documents in the Gallica digital library by author. |
| search_by_subject | Search for documents in the Gallica digital library by subject. |
| search_by_date | Search for documents in the Gallica digital library by date. Accepts YYYY, YYYY-MM, or YYYY-MM-DD format. |
| search_by_document_type | Search for documents in the Gallica digital library by document type (e.g., monographie, periodique, image, manuscrit, carte, musique, etc.). |
| advanced_search | Perform an advanced search using custom CQL query syntax. Examples: dc.creator all "Victor Hugo" and dc.type all "monographie", dc.subject all "Paris" and dc.type all "carte", dc.language all "eng". |
| natural_language_search | Search the Gallica digital library using natural language. This is a simplified search that uses the "gallica all" operator to search across all fields. |
| get_item_details | Get full metadata for a Gallica item by its ARK identifier. Returns bibliographic data, available formats, and helpful URLs. |
| get_item_pages | Enumerate pages of a document. Returns logical page numbers, IIIF image URLs, and text availability flags. |
| get_page_image | Get IIIF image URL for a specific page. Returns URL and metadata, not binary data. |
| get_page_text | Retrieve OCR or TEI text for a specific page when available. Returns null if text is not available. |
| sequential_reporting | Generate a research report in a sequential, step-by-step manner using Gallica BnF sources. This tool follows a sequential approach to report generation:
Parameters:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |