Quran Search Engine MCP

🚀 コーラン検索エンジンMCP

このツールは、AIと本物のコーランのテキストの間のギャップを埋めるために開発されました。AIがコーランの経文を「幻想」したり予測したりするのではなく、このツールは検索リクエストを専用の正確な検索エンジンに転送します。

✨ 主な機能

• 🔌 MCP互換：Claude Desktopや他のMCPクライアントとシームレスに動作します。
• 🔍 高度な検索：アラビア語の正規化、語幹、ルートベースの検索をサポートします。
• 📖 正確な結果：幻想的な内容を含まず、正確な経文を返します。
• 📄 ページネーション：多数の検索結果をページネーションで処理します。
• ✨ ハイライト：一致した用語を明確にマークします。

📦 インストール

pnpm install

🔧 ビルド

pnpm build

🔨 ローカル開発

pnpm dev

🧪 テスト

pnpm test

🧹 リント

pnpm lint

🚀 公開

pnpm build
pnpm version patch
pnpm publish --access public

📦 設定（Claude Desktop）

オプション1: クイックスタート（ユーザー向け推奨）

自分でビルドすることなく、公開されているパッケージを直接使用できます。

1. 設定ファイルを編集します。
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. サーバーエントリを追加します。

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "command": "npx",
      "args": ["quran-search-engine-mcp"]
    }
  }
}

3. Claude Desktopを再起動します。

オプション2: ローカル開発（貢献者向け）

1. サーバーをビルドします。

pnpm build

2. 設定ファイルを編集します。 %APPDATA%\Claude\claude_desktop_config.json
3. サーバーエントリを追加します。

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "command": "node",
      "args": ["D:\\path\\to\\quran-search-engine-mcp\\dist\\server.js"]
    }
  }
}

注: D:\\path\\to\\... を実際のプロジェクトの絶対パスに置き換えてください。 4. Claude Desktopを再起動します。

💻 使用例

設定が完了したら、チャットで使用できます。 「コーランの中から「الحمد」を検索して結果を表示して。」 結果として、コーラン関連のクエリは直接サーバーに送信され、サーバーが正しい経文を返します。

例: 預言者ユヌスの検索

このエンジンは文脈や同義語を理解します。たとえば、「すべての同義語を含む預言者ユヌスを検索」すると、以下のような結果が得られます。

"すべての同義語を含む預言者ユヌスを検索" 結果には、ユヌス、ユヌスの民、さらにはズル・ヌン（クジラと共にいた者）に関連する経文が含まれます。

名前のみで検索を制限した場合でも、結果は正確です。これは、AIが意図を理解し、データが信頼できるソースから取得されていることを証明しています。

🔍 quran-search-engineの使用

このサーバーは、コアの検索ロジック、アラビア語の正規化、語幹/ルートのマッチング、およびハイライトに quran-search-engine パッケージを使用しています。詳細は https://www.npmjs.com/package/quran-search-engine を参照してください。

まとめ

quran-search-engine-mcp は、MCP互換のAIを信頼できるコーラン検索ソースに変えます。すべての処理はサーバーを通して行われ、テキストは常に正しく、AIはクエリのみを処理します。

これにより、教育アプリケーション、スマートアシスタント、または幻想的な内容のない信頼できる現実的なコーラン検索が必要な任意のプロジェクトに道が開かれます。

📄 ライセンス

MIT

🤝 貢献

詳細は CONTRIBUTING.md を参照してください。

📧 お問い合わせ

Email: contact@adelpro.us.kg

📋 要件

• Node.js LTS
• pnpm