quran-search-engine-mcp

Quran Search Engine MCP

AI クライアントに、検索、ナビゲーション、形態論を通じてコーランへ高速かつ正確に、 幻覚のないアクセスを提供する MCP（Model Context Protocol）サーバーです。 stdio と Streamable HTTP に対応しています。

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 など。
• 🌐 2 種類のトランスポート — ローカル統合向けの stdio、リモート／ホスト型向けの Streamable HTTP。
• 🔍 8 つのツール — 全文検索、スーラのメタデータ、節のナビゲーション、レンマ／語根の検索、形態論。
• 📖 正確な結果 — すべての節は検証済みデータセットから取得されます。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]