BnF API 服务器

一个 MCP (模型-客户端-协议) 服务器，用于访问法国国家图书馆 (BnF) 的 Gallica API 并生成顺序研究报告。

功能

• 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 替换为您的安装目录的实际路径。

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

可用的 MCP 工具

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

Gallica 搜索

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

顺序报告生成

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

• 格式化的书目
• 简介
• 历史背景
• 分析
• 结论
• 相关的图像和地图（可选）

项目结构

mcp-bnf/
│
├── bnf_server.py              # 主要 MCP 服务器
├── requirements.txt           # 项目依赖项
│
└── bnf_api/                   # BnF API 包
    ├── __init__.py            # 包导出
    ├── api.py                 # Gallica BnF API 客户端
    ├── search.py              # 搜索功能
    ├── config.py              # 常量和配置
    └── sequential_reporting.py # 顺序报告生成工具

使用方法

使用 Claude Desktop 配置后，您可以要求 Claude 使用 BnF 工具来：

1. 搜索文档:

   • "在 Gallica 中搜索关于 Victor Hugo 的书籍"
   • "查找 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

许可证

本项目是开源的。