圣经MCP
全面 模型上下文协议（MCP） 该服务器为人工智能助手提供访问世界主要宗教（包括基督教、伊斯兰教、犹太教、印度教、佛教、锡克教和道教）神圣经文的权限。
特性
- 🔍 高级搜索：通过宗教、书籍、章节、语言和版本过滤，在多部神圣经文中进行全文搜索
- 📚 多宗教支持：基督教（KJV圣经）、伊斯兰教（古兰经）、犹太教（Tanakh）、印度教（薄伽梵歌）、佛教（法）和道教（道德经）
- 🌐 多种语言：支持原始语言（希伯来语、梵语、中文）和英语翻译
- 📖 精确参考：按书籍、章节和诗句编号检索特定诗句
- 🎲 随机文本：获取随机诗句以获得灵感或学习
- ⚡ 高性能：具有相关性评分的快速内存搜索
- 🔧 生产就绪：全面的错误处理、日志记录和监控
目前可用的圣经
基督教
- 英王钦定本（KJV） -最受欢迎的英文圣经翻译（31102节）
伊斯兰
- 古兰经（沙希国际） -通俗英语翻译（6236节）
犹太教
- 塔纳赫 -完整的希伯来圣经（托拉、涅瓦伊姆、凯图维姆）（23200节）
印度教
- Bhagavad 吉他 -梵文和英文圣经（18章700节）
佛教
- 达玛帕达 -佛教格言集（423节）
道教
- 道德经 -老子道教基础文本（81章）
未来计划增加
基督教
- 世界英语圣经（WEB -高品质公共领域圣经
- 新国际版（NIV） -现代英语翻译
- 英语标准版（ESV） -直译
- 新美国标准圣经（NASB） -直译
伊斯兰
- 古兰经（阿拉伯语原文） -带音译的阿拉伯原文
- 布哈里先生 -正宗圣训系列
- 穆斯林圣训实录 -正宗圣训系列
犹太教
- 托拉（希伯来语） -威斯敏斯特列宁格勒法典，带元音点
- 密西拿 -口头律法汇编
- 《塔木德》 -密西拿的拉比讨论
印度教
- 《梨俱吠陀》 -古代印度教圣典
- 娑摩吠陀 -吠陀圣歌和旋律
- 雅诸·韦达 -牺牲公式
- 阿塔尔瓦 韦达 -赞美诗和咒语
- 奥义书 -哲学文本
- 罗摩衍那 -拉玛史诗
- 摩诃婆罗多 -伟大的史诗，包括《薄伽梵歌》
佛教
- 大藏经（巴利语正典） -完整的巴利佛教经典
- 妙法莲华经 -大乘佛教文本
- 心经 -大乘佛教核心教义
- 金刚经 -智慧文本的完善
锡克教
- 大师 Granth Sahib -锡克教的核心宗教文本
- 达萨姆·格兰思 -锡克教次级经文
耆那教
- 蜥蜴 -典型的耆那教文本
- 塔特瓦尔塔经 -耆那教哲学
琐罗亚斯德教
- 阿维斯塔 -琐罗亚斯德教经文
- 伽泰 -琐罗亚斯德赞美诗
其他传统
- 摩门经 -后期圣典
- 教义和圣约 -LDS启示
- 基塔布-阿克达斯 -巴哈伊最神圣的书
- 基塔布·伊坎 -巴哈伊确信之书
安装
先决条件
- Node.js 18.0.0或更高版本
- npm或yarn包管理器
快速设置
- 克隆存储库：
git clone https://github.com/your-username/sacred-scriptures-mcp.git
cd sacred-scriptures-mcp- 运行安装脚本：
chmod +x setup.sh
./setup.sh- 启动服务器：
npm start手动安装
- 安装依赖项：
npm install- 构建项目：
npm run build- 配置环境：
cp config.example.env .env- 将您的数据文件添加到
data/目录 （参见 数据文件 部分）
- 启动服务器：
npm start数据文件
服务器需要JSON数据文件 data/ 目录。目前包括：
kjv_bible.json-英王钦定本圣经（31102节）quran_english.json-古兰经（英文译本）（6236节）tanakh.json-希伯来圣经/Tanakh（23200节）bhagavad_gita_verses.json-《博伽梵歌》经文（700节）bhagavad_gita_chapters.json-薄伽梵歌章节信息bhagavad_gita_translations.json-《薄伽梵歌》译本dhammapada.json-佛经（423节）taoteching.json-《道德经》（81章）
MCP工具
服务器为AI助手提供以下工具：
1. search_religious_texts
使用高级过滤选项搜索神圣经文。
参数：
query（必填）：搜索查询文本religion（可选）：按宗教（基督教、伊斯兰教、犹太教等）过滤book（可选）：按书名过滤（创世记、马太福音、古兰经等）chapter（可选）：按章节号筛选language（可选）：按语言筛选（英语、阿拉伯语、希伯来语等）version（可选）：按版本筛选（KJV、NIV、ESV等）limit（可选）：返回的最大结果数（默认值：50）offset（可选）：分页时跳过的结果（默认值：0）exactMatch（可选）：精确短语匹配（默认值：false）
例子：
{
"query": "love your neighbor",
"religion": "Christianity",
"book": "Matthew",
"limit": 10
}2. get_text_by_reference
通过书籍、章节和经文参考获得具体的圣经。
参数：
book（必填）：书名（例如，创世记、马太、法提哈）chapter（必填）：章节编号verse（可选）：诗句编号（如果省略，则返回所有诗句）religion（可选）：按宗教过滤以消除书名歧义
例子：
{
"book": "John",
"chapter": 3,
"verse": 16,
"religion": "Christianity"
}3. get_random_text
获取随机的神圣经文，可选择按宗教过滤。
参数：
religion（可选）：按宗教过滤
例子：
{
"religion": "Buddhism"
}4. list_available_religions
获取数据库中所有可用宗教的列表。
无需参数。
5. list_available_books
获取所有可用书籍的列表，可选择按宗教过滤。
参数：
religion（可选）：按宗教过滤书籍
例子：
{
"religion": "Islam"
}6. get_server_status
获取有关服务器状态和已加载数据源的信息。
无需参数。
配置
可以使用中的环境变量配置服务器 .env 文件：
# Data Configuration
DATA_PATH=./data
# Server Configuration
MCP_SERVER_NAME=sacred-scriptures-mcp
MCP_SERVER_VERSION=1.0.0
LOG_LEVEL=info
# Performance Settings
MAX_SEARCH_RESULTS=100
SEARCH_TIMEOUT_MS=5000
CACHE_EXPIRY_HOURS=24发展
脚本
npm start-启动服务器npm run dev-以开发模式启动npm run build-将TypeScript构建为JavaScriptnpm test-运行测试（如果可用）
项目结构
sacred-scriptures-mcp/
├── src/
│ ├── index.ts # Main server entry point
│ ├── services/
│ │ └── text-manager.ts # Text management and search
│ ├── parsers/
│ │ ├── base.ts # Base parser interface
│ │ └── json.ts # JSON data parser
│ ├── sources/
│ │ └── index.ts # Data source configurations
│ └── types/
│ └── index.ts # TypeScript type definitions
├── data/ # Sacred scripture data files
├── config.example.env # Example configuration
├── package.json # Node.js dependencies
├── tsconfig.json # TypeScript configuration
└── setup.sh # Automated setup scriptDocker支持
使用Docker
- 构建Docker镜像：
docker build -t sacred-scriptures-mcp .- 运行容器：
docker run -p 3000:3000 -v $(pwd)/data:/app/data sacred-scriptures-mcp使用Docker Compose
docker-compose up -d生产部署
环境设置
- 设置生产环境变量：
export NODE_ENV=production
export LOG_LEVEL=warn
export DATA_PATH=/app/data- 生产建设：
npm run build- 从流程管理器开始：
pm2 start dist/index.js --name sacred-scriptures-mcp健康检查
服务器包括健康检查终结点：
- 状态：检查服务器状态和加载的数据源
- 指标：获取性能指标和统计数据
监控
- 服务器日志被写入stderr以便于收集
- SIGINT和SIGTERM的优雅关机处理
- 具有详细错误消息的全面错误处理
API示例
搜索关于爱情的诗句
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_religious_texts",
"arguments": {
"query": "love",
"religion": "Christianity",
"limit": 5
}
}
}'获取特定的诗句
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_text_by_reference",
"arguments": {
"book": "John",
"chapter": 3,
"verse": 16
}
}
}'贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
添加新的圣经
- 将数据文件添加到
data/目录 - 更新
TEXT_SOURCES配置在src/sources/index.ts - 如果需要，创建适当的解析器
- 测试集成
- 更新文档
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
致谢
- 圣经数据来源：
支持
如需支持，请在GitHub上打开问题或联系维护人员。
更新日志
版本1.0.0
- 初始版本
- 支持世界主要宗教
- 高级搜索功能
- MCP协议实现
- 生产就绪部署
______________________________________________________________________
备注：此服务器旨在与支持模型上下文协议（MCP）的AI助手配合使用。它为教育和研究目的提供对神圣经文的只读访问。