BnF API 服务器

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

功能

• 在 Gallica 中搜索：搜索文档、图像、地图和其他资源
• 生成序列报告：自动生成结构化的主题研究报告
• 集成图形：在生成的报告中包含相关图像和地图
• 格式化引用：自动生成格式正确的 bibliography

安装

先决条件

• 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 中搜索

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

生成序列报告

根据 Gallica 的来源生成完整的主题研究报告。报告包括：

• 格式化的 bibliography
• 引言
• 历史背景
• 分析
• 结论
• 相关图像和地图（可选）

项目结构

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

使用

配置完成后，您可以在 Claude Desktop 中使用以下命令：

1. 搜索文档：

   • "在 Gallica 中搜索关于 Victor Hugo 的书籍"
   • "查找 19 世纪巴黎的地图"

2. 生成报告：

   • "创建关于印象派的报告"
   • "生成关于法国 mandate 下黎巴嫩历史的报告并附带图像"

开发

要为项目做出贡献：

1. 克隆存储库：

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

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 运行测试

   python test_bnf_api.py
   

4. 提交更改

   git add .
   git commit -m "您的提交信息"
   git push origin main
   

许可

该项目受 [许可证名称] 许可证的保护。