quran_cloud_mcp_server

Name: quran_cloud_mcp_server
Author: marwanWaly

@marwanWaly

リポジトリ

quran_cloud_mcp_server について

MCP server to help LLMs to get access to Quran API (https://alquran.cloud/api).

#quran #llm #api #mcp-server

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

marwanWaly

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "Search-Quran": {
      "command": "python",
      "args": [
        "PROJECT_PATH_ON_YOUR_PC\\server.py"
      ],
      "host": "127.0.0.1",
      "port": 8080,
      "timeout": 30000
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is quran_cloud_mcp_server?

A Model Context Protocol (MCP) server that connects large language models to the free Quran API (alquran.cloud) to retrieve accurate Quranic text and reduce hallucination. It is designed for developers working with sensitive Quran data where each character matters.

How to use quran_cloud_mcp_server?

Clone the repository, create a Python virtual environment, install dependencies from requirements.txt, create a .env file with your OPENAI_API_KEY, then run python client.py to chat with GPT‑4o in the terminal. To connect to Claude Desktop, edit claude_desktop_config.json by adding an MCP server entry pointing to server.py (host 127.0.0.1, port 8080) and restart Claude.

Key features of quran_cloud_mcp_server

Provides LLMs access to the Quran API to reduce hallucination
Retrieves only the needed Quran data efficiently
Connects to Claude Desktop via MCP configuration
Supports terminal chat with GPT‑4o via client.py
Uses the free Quran API (alquran.cloud)

Use cases of quran_cloud_mcp_server

LLM‑based Quranic research without text hallucination
Enhancing Claude desktop with accurate Quranic references
Building chatbots that answer questions about Quran verses
Integrating Quran data into AI applications via the API

FAQ from quran_cloud_mcp_server

What is the purpose of this MCP server?

It connects LLMs to the Quran API to prevent hallucination when dealing with Quran text.

How do I install and run the server?

Clone the repo, create a Python venv, install requirements, create a .env file with your OPENAI_API_KEY, then run python client.py.

How do I connect the server to Claude Desktop?

Edit the Claude Desktop config file (claude_desktop_config.json) to add an MCP server entry pointing to server.py with host 127.0.0.1 port 8080, then restart Claude.