mcpField
Q
quran-search-engine-mcp

quran-search-engine-mcp

本地服务
github.com/adelpro搜索与检索612 周前更新
代码仓库

关于 quran-search-engine-mcp

quran-search-engine-mcp 是面向需要精确《古兰经》文本及相关查询的 AI 客户端的 MCP 服务。它使用专用搜索引擎和经过验证的数据集，而非由 LLM 生成经文。

主要功能

  1. 01《古兰经》全文搜索
  2. 02章节与经文导航
  3. 03词元与词根查询
  4. 04形态学查询
  5. 05stdio 与 Streamable HTTP 传输

适用场景

  1. 01为问题检索准确的《古兰经》经文
  2. 02定位章节或经文
  3. 03查询阿拉伯语词元与词根
  4. 04查看词语形态信息

MCP 相关

提供八种 MCP 工具，用于《古兰经》搜索、导航、元数据、词元和词根查询及形态学查询。客户端可通过 stdio 或 Streamable HTTP 连接，包括托管端点。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "adelpro-quran-search-engine": {
      "command": "npx",
      "args": [
        "-y",
        "quran-search-engine-mcp"
      ]
    }
  }
}
启动命令npx -y quran-search-engine-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmquran-search-engine-mcp0.2.1

工具

1

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pageinteger否
rootboolean否
lemmaboolean否
limitinteger否
querystring是

详细介绍

Quran Search Engine MCP

npm version MCP Registry smithery badge license Powered by quran-search-engine quran-search-engine

一个 MCP（Model Context Protocol）服务，可通过 stdio 和 Streamable HTTP，为 AI 客户端快速、准确地提供无幻觉的《古兰经》访问能力，包括搜索、导航和形态分析。

通过 8 个 MCP 工具搜索、导航和探索《古兰经》：经文、章、词元、词根和形态分析。托管于 mcp.quran.us.kg。 该工具不会依赖 AI“幻觉”或预测《古兰经》经文，而是将每个请求路由到专用搜索引擎。AI 负责处理自然语言；服务则返回准确、原文的《古兰经》文本。

公共端点

该服务公开托管于 https://mcp.quran.us.kg/ （由 Cloudflare 提供前置服务，稳定可靠）。无需 API 密钥或身份验证——该端点开放，并启用了 CORS，供任何客户端使用。

资源URL
MCP 服务（Streamable HTTP）https://mcp.quran.us.kg/
健康检查https://mcp.quran.us.kg/health
状态页面https://quran.us.kg

功能

  • 🔌 兼容 MCP — 支持 Claude Desktop、Claude Web、ChatGPT、Cursor、VS Code 等。
  • 🌐 两种传输方式 — stdio 用于本地集成，Streamable HTTP 用于远程／托管场景。
  • 🔍 八个工具 — 全文搜索、章节元数据、经文导航、词元／词根查询、形态分析。
  • 📖 结果准确 — 每节经文均来自经过验证的数据集；整个流程不涉及 LLM。
  • 🛡️ 强化的 HTTP 安全性 — 主机允许列表、按 IP 限流、请求正文大小上限、会话清理器、/health。

安装

# Use the public endpoint
# → point your MCP client at https://mcp.quran.us.kg/

# Or run the server locally (stdio)
npx -y quran-search-engine-mcp

文档

详细文档位于 docs/ 下：

  • 工具参考 — 每个工具的架构、响应格式和示例。
  • 集成 — Claude Desktop、Claude Web、ChatGPT、Cursor 等。
  • 架构 — 内部实现：传输方式、数据集加载、HTTP 安全强化。
  • 开发 — 构建、测试、添加新工具、部署。

快速开始（HTTP）

最简单的方法：使用任意 MCP 客户端，并将其指向 https://mcp.quran.us.kg/。 如需临时测试，集成页面 提供了一个直接使用 @modelcontextprotocol/sdk 的一次性 Node 代码片段。

快速开始（Docker）

docker compose up --build
# → "Quran MCP HTTP server listening on http://0.0.0.0:4000/"

要求

  • Node.js 20+（推荐 LTS）
  • npm、pnpm 或 yarn

许可证

MIT — 详见 LICENSE。

联系方式

电子邮件：[email protected]

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。