Quran MCP

古兰经MCP服务器🕌 - 伊斯兰革命AI助理

](https://www.npmjs.com/package/@quranmcp/server) 

A. 革命的 模型上下文协议（MCP）服务器，使AI助手能够强大地访问伊斯兰资源。第一台MCP服务器 智能关键字搜索 对于《古兰经》和《圣训》来说，不再需要精确的经文编号了！

✨ 是什么让这场革命？

🔍 智能搜索 新

• 按关键词搜索古兰经：在不知道经文编号的情况下，找到关于“耐心”、“祈祷”、“怜悯”的经文
• 按主题搜索圣训：立即发现关于“慈善”、“斋戒”、“礼仪”的圣训
• 基于主题的发现：AI了解常见的伊斯兰话题并找到相关内容
• 自然语言查询：问“找到关于耐心的经文”，并立即得到结果

📖 全面的古兰经访问

• 阿拉伯语文本：阿拉伯文古兰经原文
• 多个翻译：知名学者（Asad、Sahih International、Pickthall、Yusuf Ali、Hilali&Khan）的英文翻译
• 完整苏拉检索：获取完整的章节，包括或不包括翻译
• 随机诗句：每日灵感专题
• 逐节访问：传统的基于参考的查找

📚 塔夫希尔（评论）

• 多个来源：访问各种塔夫希尔收藏

- 塔夫西尔·伊本·卡蒂尔（英语和阿拉伯语） - Maarif ul quran - 塔菲尔·塔巴里（阿拉伯语） - Tafsir al-Qurtubi（阿拉伯语）

• 逐节解释：详细的学术评论

📜 圣训收藏

• 六大收藏:

- 布哈里（7563圣训） - 萨希赫穆斯林（7563圣训） - 苏南·阿布·达乌德（5274圣训） - 贾米·蒂米迪（3956圣训） - 苏南-纳萨伊（5758圣训） - 苏南·伊本·马贾（4341圣训）

• 随机圣训：每日圣训特辑

🎵 音频背诵

• 多接收器：从著名的古兰经朗诵者中选择

- 马赫尔·穆艾克利 - 阿卜杜勒·巴希特 - 阿卜杜拉赫曼·苏达斯 - 米沙里·拉希德·阿拉法西 - 马哈茂德·哈利勒·胡萨里

• 高品质音频：各种比特率的MP3格式
• 播放列表生成：完整Surah的M3U播放列表

⚡ 性能特点

• 智能高速缓存：具有TTL的LRU缓存，可最大限度地减少API调用
• 错误处理：通过有意义的消息进行全面的错误处理
• 类型安全：具有严格模式的完整TypeScript实现
• 验证：所有参数的输入验证

🚀 安装-只需复制和粘贴！

步骤1：添加到您的AI代理

Claude桌面版 -将以下内容添加到您的配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quran": {
      "command": "npx",
      "args": ["@quranmcp/server"]
    }
  }
}

第二步：重启克劳德

第三步：完成！ 🎉

问： “在古兰经中寻找关于忍耐的经文”

______________________________________________________________________

可与任何兼容MCP的AI代理配合使用 -只需使用相同的JSON配置！

🛠️ 可用工具（共18个）

🔍 新搜索工具（革命性）

search_quran

按关键字或短语搜索古兰经 -在不知道确切参考文献的情况下寻找经文！

{
  "query": "patience",
  "translation": "en.sahih",
  "max_results": 20
}

查询示例：

• “耐心”-查找所有关于耐心的经文
• “那些相信的人”-找到这句话的经文
• “祈祷”-探索关于祈祷的经文
• “宽恕”-多个关键词

search_hadith

按关键字搜索圣训收藏 -发现任何话题的圣训！

{
  "query": "charity",
  "collections": ["bukhari", "muslim"],
  "max_results": 20
}

查询示例：

• “祈祷时间”-寻找关于祈祷的圣训
• “斋戒斋月”-关于斋戒的圣训
• “父母”-圣训关于对待父母

search_quran_by_topic

按预定义的伊斯兰主题搜索 -AI优化主题搜索！

{
  "topic": "patience",
  "translation": "en.sahih",
  "max_results": 10
}

可用主题： 祈祷、耐心、慈善、信仰、天堂、地狱、先知、安拉、怜悯、正义、知识、家庭、死亡、创造、指导

search_hadith_by_topic

按伊斯兰主题搜索圣训 -基于主题的圣训发现！

{
  "topic": "prayer",
  "collections": ["bukhari"],
  "max_results": 10
}

可用主题： 祈祷、斋戒、慈善、朝觐、信仰、先知、同伴、知识、礼仪、家庭、婚姻、死亡、圣战、悔改

📖 古兰经工具

get_quran_verse

用阿拉伯语文本和翻译获得一首特定的诗。

{
  "surah": 1,
  "ayah": 1,
  "translation": "en.asad"
}

get_full_surah

获取完整古兰经的所有经文。

{
  "surah": 1,
  "include_translation": true,
  "translation": "en.asad"
}

get_random_verse

随机选择一首诗作为日常灵感。

{
  "include_translation": true,
  "translation": "en.asad"
}

翻译工具

get_tafsir

获取一首诗的评论/解释。

{
  "surah": 2,
  "ayah": 255,
  "tafsir": "en-tafisr-ibn-kathir"
}

list_tafsir_sources

列出所有可用的Tafsir来源。

圣训工具

get_hadith

从收藏中获取特定的圣训。

{
  "collection": "bukhari",
  "hadith_number": 1
}

get_random_hadith

随机得到一个圣训。

{
  "collection": "bukhari"
}

list_hadith_collections

列出所有可用的圣训收藏。

背诵工具

get_recitation_url

获取诗歌朗诵的音频URL。

{
  "surah": 1,
  "ayah": 1,
  "reciter": "Maher_AlMuaiqly_64kbps"
}

list_reciters

列出所有可用的独奏者。

信息工具

get_surah_info

获取有关苏拉的信息。

{
  "surah": 1
}

list_surahs

列出所有114章及其信息。

list_translations

列出所有可用的翻译。

get_cache_stats

获取用于监视的缓存统计信息。

💬 AI助手的示例查询

配置后，您可以向AI助手提出自然语言问题：

🔍 搜索查询（新增！）

• 在《古兰经》中寻找关于忍耐的经文
• “搜索关于慈善的圣训”
• “给我看看古兰经中关于祈祷的经文”
• “找到对待父母的圣训”
• “《古兰经》怎么说慈悲？”
• “寻找包含‘信者’的经文”
• “寻找斋月斋戒圣训”

📖 传统查询

• “给我看阿亚特·库尔西（2:255节）的翻译和塔夫希尔”
• “今天给我随机找一节古兰经”
• “法蒂哈章说了什么？”
• “给我看看布哈里圣训1号”
• “给我一个随机圣训”
• “获取Surah Yasin的音频朗诵URL”
• “列出所有可用的古兰经翻译”
• “关于黄牛章的信息是什么？”

🎯 AI理解

AI助手现在明白它可以：

• 按关键字搜索，而不是要求精确的诗句编号
• 在不知道参考文献的情况下按主题查找内容
• 通过自然语言发现相关的经文和圣训
• 将搜索与传统查找相结合，进行综合研究

🏗️ 建筑

quranMCP/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── types/                # TypeScript type definitions
│   │   └── index.ts
│   ├── constants/            # Constants and validation
│   │   └── index.ts
│   ├── services/             # Core services
│   │   ├── cache.ts          # Caching layer
│   │   └── fetcher.ts        # HTTP client
│   └── tools/                # Tool implementations
│       ├── quran.ts          # Quran text & translations
│       ├── tafsir.ts         # Tafsir commentary
│       ├── hadith.ts         # Hadith collections
│       └── recitation.ts     # Audio recitations
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

🔧 发展

构建

npm run build

观看模式

npm run dev

MCP检验员测试

npm run inspector

📊 数据源

此服务器聚合来自多个受信任的伊斯兰资源的数据：

• 翻译: spa5k/翻译_api
• 圣训: fawazahmed0/hadwith api
• 阿拉伯语古兰经: fawazahmed0/quran api
• 古兰经翻译: 古兰经云API
• 背诵: EveryAyah.com

🎯 为什么这个MCP服务器是革命性的

在此服务器之前：

• ❌ 必须知道苏拉和阿亚的确切数字
• ❌ 无法按关键字或主题搜索
• ❌ 需要在外部资源中手动查找
• ❌ 仅限于基于参考的查询

使用此服务器：

• ✅ 自然语言搜索 -“寻找关于耐心的诗句”
• ✅ 基于关键字的发现 -搜索整个古兰经和圣训收藏
• ✅ 主题感知AI -AI了解伊斯兰主题并找到相关内容
• ✅ 通用兼容性 -可与任何兼容MCP的AI代理配合使用
• ✅ 零安装选项 -立即与NPX一起使用
• ✅ 智能缓存 -智能缓存快速响应
• ✅ 18个强大的工具 -全面的伊斯兰资源获取

现实世界影响：

• 学生：在不记忆参考文献的情况下，发现用于研究的经文和圣训
• 教育工作者：快速找到相关的伊斯兰文本进行教学
• 研究人员：同时搜索多个来源
• 日常用户：获得伊斯兰问题的即时答案
• 开发者：轻松构建伊斯兰人工智能应用程序

🤝 贡献

欢迎投稿！这是一个面向穆斯林社区的开源项目。

优先领域：

• 其他Tafsir来源（更多语言）
• 更多圣训收藏
• 其他翻译（乌尔都语、阿拉伯语、法语等）
• 增强的搜索算法
• 改进专题索引
• Juz/Hizb导航
• 性能优化

如何做出贡献：

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

📦 包裹信息

• NPM包： @quranmcp/服务器
• 版本： 2.0.0
• 许可证： 麻省理工学院
• 存储库：
• 尺寸： 34.3 kB（压缩）
• Node.js： >= 18.0.0

📄 许可证

麻省理工学院许可证-请在您的项目中自由使用！

🙏 致谢

• 所有免费提供这些伊斯兰资源的学者和组织
• Anthropic的模型上下文协议团队
• 开源社区

📞 支持

• 问题：
• 讨论：
• NPM： @quranmcp/服务器

📚 更多示例

看 示例.md 查看详细的使用示例。

______________________________________________________________________

由以下材料制成❤️ 面向穆斯林社区和人工智能爱好者

状态： 🟢 NPM直播|✅ 准备使用|🚀 已启用革命性搜索