article
README
🚀 BnF API 服务器
BnF API 服务器是一个基于 MCP(模型 - 客户端 - 协议)的服务器,可用于访问法国国家图书馆(BnF)的 Gallica API,并生成序列研究报告,为用户提供便捷的文献搜索和报告生成服务。
✨ 主要特性
- 在 Gallica 中搜索:可搜索文档、图像、地图和其他资源,支持使用不同标准(标题、作者、主题、日期、文档类型)进行搜索。
- 生成序列报告:能自动生成结构化的主题研究报告,内容涵盖格式化的 bibliography、引言、历史背景、分析、结论等。
- 集成图形:在生成的报告中可包含相关图像和地图,增强报告的可视化效果。
- 格式化引用:自动生成格式正确的 bibliography,方便用户引用文献。
📦 安装指南
先决条件
- Python 3.8 或更高版本
- Pip(Python 包管理器)
安装步骤
- 克隆存储库:
git clone https://github.com/votre-nom/mcp-bnf.git
cd mcp-bnf
- 安装依赖项:
pip install -r requirements.txt
📚 详细文档
与 Claude Desktop 配置
- 安装 Claude Desktop(如果尚未安装)。
- 打开 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 中使用以下命令:
- 搜索文档:
- "在 Gallica 中搜索关于 Victor Hugo 的书籍"
- "查找 19 世纪巴黎的地图"
- 生成报告:
- "创建关于印象派的报告"
- "生成关于法国 mandate 下黎巴嫩历史的报告并附带图像"
开发
要为项目做出贡献:
- 克隆存储库:
git clone https://github.com/votre-nom/mcp-bnf.git
cd mcp-bnf
- 安装依赖项:
pip install -r requirements.txt
- 运行测试
python test_bnf_api.py
- 提交更改
git add .
git commit -m "您的提交信息"
git push origin main
📄 许可证
该项目受 [许可证名称] 许可证的保护。
扫码联系在线客服