BnF API 服务器

这是一个用于访问法国国家图书馆（BnF）Gallica API 并生成顺序研究报告的 MCP（Model-Client-Protocol）服务器。

功能

• Gallica 搜索：在数字图书馆 Gallica 中搜索文档、图片、地图和其他资源
• 顺序报告生成：自动生成关于任何主题的结构化研究报告
• 图表整合：在生成的报告中包含相关图片和地图
• 格式化引用：自动生成带有正确格式引用的参考书目

安装

先决条件

• Python 3.8 或更高版本
• Pip (Python 包管理器)

安装步骤

1. 克隆仓库:

   git clone https://github.com/votre-nom/mcp-bnf.git
   cd mcp-bnf
   

2. 安装依赖:

   pip install -r requirements.txt
   

使用 Claude Desktop 配置

1. 如果尚未安装，请先安装 Claude Desktop。

2. 打开 Claude Desktop 的配置：

   • 访问 Claude Desktop 设置
   • 打开配置文件（通常位于 %APPDATA%\Claude\claude_desktop_config.json）

{
 "bnf": {
  "command": "py",
  "args": [
    "c:\\chemin\\vers\\mcp-bnf\\bnf_server.py"
  ],
  "cwd": "c:\\chemin\\vers\\mcp-bnf"
},

将 chemin\\vers\\mcp-bnf 替换为您的实际安装目录路径。

1. 保存配置文件 并重启 Claude Desktop

可用的 MCP 工具

配置完成后，以下工具将在 Claude Desktop 中可用：

在 Gallica 中搜索

允许使用不同标准（标题、作者、主题、日期、文档类型）在 BnF 的数字图书馆 Gallica 中搜索文档。

顺序报告生成

利用 Gallica 的资源创建关于任何主题的完整研究报告。报告包括：

• 格式化的参考书目
• 引言
• 历史背景
• 分析
• 结论
• 相关图片和地图（可选）

项目结构

mcp-bnf/
│
├── bnf_server.py              # Serveur MCP principal
├── requirements.txt           # Dépendances du projet
│
└── bnf_api/                   # Package API BnF
    ├── __init__.py            # Exports du package
    ├── api.py                 # Client API Gallica BnF
    ├── search.py              # Fonctions de recherche
    ├── config.py              # Constantes et configuration
    └── sequential_reporting.py # Outil de génération de rapports séquentiels

使用

一旦与 Claude Desktop 配置好，您可以请求 Claude 使用 BnF 工具来执行以下操作：

1. 搜索文档：

   • "在 Gallica 中搜索有关维克多·雨果的书籍"
   • "找到 19 世纪的巴黎地图"

2. 生成报告：

   • "创建一份关于法国印象派的报告"
   • "生成一份带有图片的法国托管下的黎巴嫩历史报告"

开发

要为项目做贡献：

1. Fork 仓库
2. 为您要添加的功能创建一个分支 (git checkout -b feature/nouvelle-fonctionnalite)
3. 提交您的更改 (git commit -am 'Ajouter une nouvelle fonctionnalité')
4. 推送至该分支 (git push origin feature/nouvelle-fonctionnalite)
5. 创建 Pull Request

许可证

本项目是开源的。