Sacred Scriptures MCP

圣经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包管理器

快速设置

1. 克隆存储库：

git clone https://github.com/your-username/sacred-scriptures-mcp.git
cd sacred-scriptures-mcp

1. 运行安装脚本：

chmod +x setup.sh
./setup.sh

1. 启动服务器：

npm start

手动安装

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 配置环境：

cp config.example.env .env

1. 将您的数据文件添加到 data/ 目录 （参见 数据文件 部分）

1. 启动服务器：

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构建为JavaScript
• npm 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 script

Docker支持

使用Docker

1. 构建Docker镜像：

docker build -t sacred-scriptures-mcp .

1. 运行容器：

docker run -p 3000:3000 -v $(pwd)/data:/app/data sacred-scriptures-mcp

使用Docker Compose

docker-compose up -d

生产部署

环境设置

1. 设置生产环境变量：

export NODE_ENV=production
export LOG_LEVEL=warn
export DATA_PATH=/app/data

1. 生产建设：

npm run build

1. 从流程管理器开始：

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
      }
    }
  }'

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

添加新的圣经

1. 将数据文件添加到 data/ 目录
2. 更新 TEXT_SOURCES 配置在 src/sources/index.ts
3. 如果需要，创建适当的解析器
4. 测试集成
5. 更新文档

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 圣经数据来源：

- 道德经 - 塔纳赫 - 各种公共领域的圣典收藏

支持

如需支持，请在GitHub上打开问题或联系维护人员。

更新日志

版本1.0.0

• 初始版本
• 支持世界主要宗教
• 高级搜索功能
• MCP协议实现
• 生产就绪部署

______________________________________________________________________

备注：此服务器旨在与支持模型上下文协议（MCP）的AI助手配合使用。它为教育和研究目的提供对神圣经文的只读访问。