Gramps MCP服务器
使用Gramps Web。
______________________________________________________________________
概述
这个项目是 基于Flask的定制MCP（模块化控制点）服务器 旨在作为智能代理 Gramps Web API，首屈一指的开源家谱平台。
此服务器的主要功能是 自动访问令牌续订，允许与Gramps Web API端点进行无缝、不间断的交互，用于家谱数据管理。
______________________________________________________________________
为什么这很重要
GrampsWeb通过RESTful API提供了强大的系谱数据管理，但管理API令牌和安全身份验证对开发人员来说可能很麻烦。
此MCP服务器充当 中间件层抽象令牌处理 包括：
- 透明身份验证，令牌获取和到期续订
- 代理所有主要Gramps对象的CRUD操作(
people,families,events,places,sources,citations,repositories,media,notes) - 添加了便利端点，如
search元数据访问 - 通过提供一致且易于使用的Flask端点接口简化客户端应用程序的集成
______________________________________________________________________
特性
- 自动刷新过期的访问令牌 无需开发人员干预
- 所有标准Gramps Web API资源的动态路由生成
- 完全CRUD支持(
GET,POST,PUT,DELETE) - JSON请求/响应合规性
- 带有信息性消息的详细错误处理
- 内置搜索和元数据代理端点
- 轻松的环境配置
.env支持凭据和API URL
______________________________________________________________________
安装
- 克隆存储库
git clone https://github.com/yourusername/gramps-flask-mcp-server.git
cd gramps-flask-mcp-server- 创建并激活Python虚拟环境
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows- 安装依赖项
pip install -r requirements.txt- 创建一个
.env包含以下变量的文件：
GRAMPS_API_URL=http://your-gramps-web-instance/api
GRAMPS_USER=your_username
GRAMPS_PASSWORD=your_password______________________________________________________________________
用法
运行Flask服务器：
python app.py这将在本地启动Flask MCP服务器，通常在 http://127.0.0.1:5000.
您现在可以与它进行交互，例如：
- 获取所有人：
GET /people - 搜索家谱：
GET /search?q=Smith - 获取元数据：
GET /metadata
服务器会自动处理令牌身份验证，并在令牌过期时进行更新。
______________________________________________________________________
贡献
该项目旨在为Gramps社区服务，欢迎捐款！无论您是想添加功能、改进文档还是修复错误，您的输入都是有价值的。
- 分叉回购
- 创建要素分支
- 提交拉取请求
______________________________________________________________________
许可证
该项目根据MIT许可证获得许可。
______________________________________________________________________
致谢
- Gramps项目
- Flask、Requests、python dotenv社区
______________________________________________________________________
感谢您对开源家谱软件的支持！
______________________________________________________________________
*如果您有疑问或想使用此MCP服务器与Gramps Web共享您的集成，请随时提出问题或开始讨论。*