quran-mcp-server 是一个 MCP 服务器，旨在使 AI 模型能够访问和利用 Quran.com 的数据。它通过官方 REST API v4 提供了一系列工具，包括检索章节、经文、Juzs，以及进行古兰经搜索等功能。开发者可以利用这些工具，构建能够理解、翻译和解释古兰经经文的 AI 应用。

该服务器通过标准化的 MCP 接口与 AI 模型无缝交互，简化了数据获取和集成的流程。它支持多种查询方式，例如按章节、页码、Juz 或关键词检索经文，并提供翻译和注释信息。通过 quran-mcp-server，开发者可以轻松地将古兰经的丰富知识融入到他们的 AI 模型中，从而创造出更具深度和文化敏感性的应用。该服务器可以通过 Docker 或 Node.js 进行部署，并提供了详细的配置指南，方便开发者快速上手。

古兰经章节检索

该核心功能允许AI模型通过章节ID或章节号检索古兰经的特定章节信息。服务器通过GET /chapters/{id}和GET /chapters端点，从Quran.com API获取章节的名称、启示地点（麦加或麦地那）、经文数量等详细信息。这使得AI能够理解古兰经的结构，并根据章节特征进行分析和推理。例如，AI可以分析不同时期启示的章节在主题和风格上的差异，或者根据章节的经文数量来调整文本处理策略。

使用场景：一个AI助手可以根据用户提供的章节名称或编号，快速提供该章节的简介，包括其启示背景和主要内容。例如，用户询问“法蒂哈章”，AI可以返回该章节是古兰经的第一章，是伊斯兰教中最重要和最常背诵的章节之一。

经文内容查询

该功能使AI模型能够根据章节号、页码、Juz（段落）号、Hizb（四分之一段落）号或特定的经文Key来检索古兰经的经文内容。通过GET /verses/by_chapter/{chapter_number}等一系列端点，服务器从Quran.com API获取相应的经文文本。这使得AI能够进行深入的文本分析，例如情感分析、主题建模或关键词提取。AI还可以比较不同翻译版本的经文，以理解其细微差别。

使用场景：一个AI古兰经学习工具可以根据用户指定的章节和经文范围，提供经文的阿拉伯语原文、多种语言的翻译以及相关的注释和解读。例如，用户输入“第2章第255节”，AI可以返回该节经文（Ayatul Kursi）的原文、英文翻译以及相关的Tafsir（注释）。

古兰经术语搜索

该功能允许AI模型通过关键词搜索古兰经的内容。通过GET /search端点，服务器将用户的搜索请求传递给Quran.com API，并返回包含关键词的经文列表。这使得AI能够快速定位古兰经中与特定主题相关的经文，并进行深入的研究和分析。例如，AI可以搜索“慈善”一词，找到所有关于慈善的经文，并分析古兰经对慈善的教导。

使用场景：一个AI研究助手可以帮助研究人员快速找到古兰经中与特定主题相关的经文。例如，研究人员想要了解古兰经对“正义”的看法，可以使用该功能搜索“正义”，AI将返回所有包含“正义”一词的经文，并按照相关性排序。

多语言翻译支持

该功能允许AI模型获取古兰经经文的多种语言翻译版本。通过GET /resources/translations和GET /resources/translations/{translation_id}/info端点，服务器提供可用翻译列表以及特定翻译的详细信息。这使得AI能够比较不同语言的翻译，理解经文在不同文化语境下的含义，并进行跨语言的文本分析。

使用场景：一个多语言AI古兰经学习应用可以根据用户的语言偏好，提供经文的相应翻译版本。例如，用户可以选择英文、法文、中文等不同的翻译版本，AI将自动显示所选语言的经文内容。

经文注释(Tafsir)集成

该功能允许AI模型访问古兰经经文的Tafsir（注释）。通过GET /resources/tafsirs和GET /quran/tafsirs/{tafsir_id}端点，服务器提供可用Tafsir列表以及特定Tafsir的详细信息。这使得AI能够理解经文的深层含义，并提供更全面的解释和解读。

使用场景：一个AI古兰经学习助手可以为用户提供经文的多种Tafsir版本，帮助用户理解经文的历史背景、语言特点以及相关的法律和伦理含义。例如，用户可以查看Ibn Kathir、Al-Qurtubi等不同学者的Tafsir，了解他们对同一节经文的不同解读。