Quran

mcp-quran

Quran MCP — Al-Quran Cloud API。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースにつなぐMCPゲートウェイです。

ツール

ツール	説明
list_surahs	Quranの全114のスーラ（章）について、アラビア語名、英語名、英訳、アーヤ（節）の数、啓示の種類（メッカ啓示／メディナ啓示）を一覧表示します。
get_surah	番号（1～114）を指定して、Quranのスーラ（章）全文を取得します。選択した版のすべてのアーヤ（節）を返します。英語の場合は英訳版（例：en.asad、en.sahih）を、アラビア語の場合はquran-uthmaniを使用します。
get_ayah	参照情報（surah:ayah形式。例：「2:255」はアーヤトゥル・クルスィー）または通しのアーヤ番号（1～6236）を指定して、Quranのアーヤ（節）を1つ取得します。選択した版の節のテキストを返します（en.asad／en.sahihなどの翻訳、またはquran-uthmaniによるアラビア語）。
search_quran	アーヤ（節）を対象に、キーワードでQuranを検索します。一致した節（最大30件）と、そのスーラ（章）およびアーヤ番号を返します。デフォルトでは英訳のen.asadを使用します。別の版を指定すると、別の翻訳またはアラビア語（quran-uthmani）を検索できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "quran": {
      "url": "https://gateway.pipeworx.io/quran/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/quran/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共有ツールが約30個表示されます。接続の initialize レスポンスに正確な範囲が示され、その日の情報としての正式な回答となります。

これは意図的な仕組みであり、偶発的な多重化ではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。そのためにMCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTPで呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/list_surahs \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/list_surahs を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルのstdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "quran": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-quran"]
    }
  }
}

または、起動することを確認するために直接実行します。

npx -y @pipeworx/mcp-quran

stdin/stdout経由でMCPを使用し、initialize／tools/list／tools/call に対して、このパック固有のツールのみを返します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworxによるルーティングはありません。

ask_pipeworxの使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Quran data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT