Bibliothèque Nationale De France (Gallica)

🚀 BnF API 服務器

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 中搜索：允許在法國國家圖書館的 Gallica 數字圖書館中使用不同標準（標題、作者、主題、日期、文檔類型）搜索文檔。
• 生成序列報告：根據 Gallica 的來源生成完整的主題研究報告。報告包括格式化的參考文獻、引言、歷史背景、分析、結論以及相關圖像和地圖（可選）。

💻 使用示例

基礎用法

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

• 搜索文檔：
  • "在 Gallica 中搜索關於 Victor Hugo 的書籍"
  • "查找 19 世紀巴黎的地圖"
• 生成報告：
  • "創建關於印象派的報告"
  • "生成關於法國 mandate 下黎巴嫩歷史的報告並附帶圖像"

🔧 技術細節

項目結構

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 # 序列報告生成工具

開發流程

若要為項目做出貢獻，可按以下步驟操作：

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

📄 許可證

該項目受 [許可證名稱] 許可證的保護。