Quran Cloud MCP Server

@marwanWaly

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

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

Quran Cloud MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Quran Cloud MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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.

What runtime dependencies are required?

Python 3.13, pip, and packages listed in `requirements.txt`. An OpenAI API key stored in `.env` is also required.

Does the server require any external API keys?

Yes, an `OPENAI_API_KEY` must be set in the `.env` file to communicate with GPT‑4o.

其他分类下的更多 MCP 服务器

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one