古兰经搜索引擎MCP服务器
概述
此MCP服务器公开了强大的古兰经搜索引擎，作为AI助手和MCP兼容客户端可以使用的工具。它充当了原始搜索引擎和MCP兼容AI系统之间的桥梁。
信用与归因
这个MCP服务器是建立在原始古兰经搜索引擎之上的，并且完全依赖于它。所有搜索功能、阿拉伯语文本处理、形态分析和数据结构均由原始库提供。
原始图书馆文档
如果您需要：
- API核心文档
- 搜索算法详细信息
- 直接库使用示例
- 性能基准
- 数据源信息
👉 访问:
______________________________________________________________________
MCP服务器功能
该适配层提供：
- 精确搜索：查找阿拉伯语文本的精确匹配项
- 模糊搜索：查找相似的单词和短语
- 前缀搜索：查找以特定前缀开头的单词
- 形态分析：按词目和词根搜索
- 分页：具有限制和偏移的控制结果集
- 多语言支持：以阿拉伯语和音译文本搜索
- 性能优化：数据缓存可实现快速响应时间
安装
npm install quran-search-mcp快速开始
作为MCP服务器
启动服务器：
npx quran-search-mcp服务器将在启动期间加载一次古兰经数据，然后通过stdio监听MCP请求。
作为图书馆
导入MCP服务器功能：
import { bootstrap, createServer } from 'quran-search-mcp';
// Create and start server programmatically
const server = await createServer();
// Or use bootstrap directly
await bootstrap();______________________________________________________________________
发展
设置
# Clone the repository
git clone https://github.com/Azizham66/quran-search-MCP.git
cd quran-search-MCP
# Install dependencies for all packages
pnpm install
# Build all packages
pnpm build
# Start development mode
pnpm dev:mcp项目结构
quran-search-MCP/
├── packages/
│ └── quran-search-engine/ # Original search engine
├── mcp-server/ # MCP server adaptation
│ ├── src/ # Server source code
│ │ ├── data/ # Data caching module
│ │ ├── handlers/ # Search handlers
│ │ ├── tools/ # MCP tools
│ │ ├── types/ # Type definitions
│ │ └── index.ts # Server entry point
│ ├── dist/ # Built server files
│ ├── package.json # Server package config
│ └── tsconfig.json # TypeScript config
├── README.md # This documentation
├── CHANGELOG.md # Version history
└── package.json # Workspace configuration测试
# Run tests for the engine
pnpm test
# Test the MCP server manually
echo '{"jsonrpc": "2.0", "method": "tools/list", "params": {}, "id": 1}' | pnpm start
# Test search functionality
echo '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "search", "arguments": {"query": "الرحمن"}}, "id": 2}' | pnpm start______________________________________________________________________
建筑
MCP服务器在构建时考虑了性能：
- 数据缓存：在服务器引导过程中加载一次三个关键数据集：
- 古兰经文本：完整的古兰经经文，配以乌思马尼和标准阿拉伯语文本 - 形态图：每首诗的形态分析数据（根、引理、形式） - 词汇地图：全面的逐字映射，实现快速查找
- 类型安全：通过Zod模式验证完全支持TypeScript
- 错误处理：全面的错误处理和记录
- 内存效率高：优化数据结构，实现快速搜索操作
______________________________________________________________________
可用工具
搜索工具
在古兰经中搜索特定的文本或概念。
参数：
query（字符串，必填）：搜索词options（对象，可选）：
- limit （number）：最大结果数（默认值：20） - offset （number）：要跳过的结果数 - matchType （string）：搜索模式-“精确”、“模糊”或“前缀” - includeMorphology （布尔值）：包括形态分析 - includeWordMap （boolean）：包含单词映射数据
请求示例：
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "الرحمن",
"options": {
"limit": 5,
"matchType": "exact"
}
}
},
"id": 1
}______________________________________________________________________
API 参考
搜索结果架构
每个搜索结果包含：
sura_id：章节号aya_id_display：阿拉伯数字的韵文编号uthmani：乌萨马尼剧本文本standard：标准阿拉伯语文本sura_name：阿拉伯语章节名称sura_name_en：英文章节名称matchScore：相关性得分matchType：找到的匹配类型matchedTokens：匹配的令牌数组
响应结构
results：匹配的诗句数组counts：按匹配类型搜索统计信息pagination：分页信息
______________________________________________________________________
贡献
欢迎投稿！请阅读我们的投稿指南并提交pull请求。
开发工作流程
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
______________________________________________________________________
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
______________________________________________________________________
确认与许可
原始项目信用
- 原发动机作者：阿德尔·本亚希亚
- 原发动机项目: https://github.com/adelpro/quran-search-engine
- 原始发动机许可证：MIT
适配层
此MCP服务器适配也在MIT下获得许可，并保持与原始项目许可条款的兼容性。
- MCP服务器作者阿齐兹·哈姆丹
- MCP服务器项目: https://github.com/Azizham66/quran-search-MCP
- MCP服务器许可证：MIT
数据源
此MCP服务器使用的古兰经数据、形态和单词映射与原始古兰经搜索引擎项目提供的相同，这些搜索引擎项目来源于古兰经阿拉伯语语料库v4.0。
______________________________________________________________________
感谢Adel Benyahia创建和维护优秀的quran搜索引擎库，使这种MCP适应成为可能！
______________________________________________________________________
仓库
- GitHub: https://github.com/Azizham66/quran-search-MCP
- 问题: https://github.com/Azizham66/quran-search-MCP/issues
- npm: https://www.npmjs.com/package/quran-search-mcp