Quran.com API용 MCP 서버

MCP 서버는 공식 REST API v4를 통해 Quran.com 코퍼스와 상호 작용합니다.

개요

이는 OpenAPI 사양 에서 생성된 MCP(Model Context Protocol) 서버입니다.

엔드포인트

다음 API 엔드포인트는 LLM이 호환 클라이언트를 통해 사용할 수 있는 도구로 제공되었습니다.

장

GET /chapters - 챕터 목록
GET /chapters/{id} - 챕터 가져오기
GET /chapters/{chapter_id}/info - 챕터 정보 가져오기

구절

GET /verses/by_chapter/{chapter_number} - 장/수라 번호별 구절 가져오기
GET /verses/by_page/{page_number} - 특정 마다니 무샤프 페이지의 모든 구절을 가져옵니다.
GET /verses/by_juz/{juz_number} - Juz 번호로 구절 가져오기
GET /verses/by_hizb/{hizb_number} - Hizb 번호로 구절 가져오기
GET /verses/by_rub/{rub_el_hizb_number} - Rub el Hizb 번호로 구절을 받으세요
GET /verses/by_key/{verse_key} - 키로 구절 가져오기
GET /verses/random - 무작위 구절을 가져옵니다

주스스

GET /juzs - 모든 juzs 목록 가져오기

찾다

GET /search - 특정 용어로 꾸란 검색

번역

GET /resources/translations - 사용 가능한 번역 목록 가져오기
GET /resources/translations/{translation_id}/info - 특정 번역에 대한 정보를 가져옵니다.

타프시르

GET /resources/tafsirs - 사용 가능한 tafsir 목록 가져오기
GET /resources/tafsirs/{tafsir_id}/info - 특정 tafsir의 정보를 가져옵니다.
GET /quran/tafsirs/{tafsir_id} - 단일 tafsir 가져오기

오디오

GET /resources/chapter_reciters - 챕터 낭송자 목록
GET /resources/recitation_styles - 사용 가능한 낭송 스타일 가져오기

언어

GET /resources/languages - 모든 언어 가져오기

설정

요구 사항

노드.js 22+
도커

Docker 이미지 빌드

Docker 기반 프로덕션 모드를 사용하기 전에 Docker 이미지를 빌드해야 합니다.

지엑스피1

Claude 데스크톱 통합

Claude Desktop과 함께 이 MCP 서버를 사용하려면 다음 구성을 claude_desktop_config.json 파일에 추가하세요(일반적으로 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있고 Windows에서는 %APPDATA%\Claude\claude_desktop_config.json 에 있습니다).

Docker 기반 프로덕션 모드

{
  "mcpServers": {
    "quran-api": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "API_KEY=your_api_key_if_needed", "-e", "VERBOSE_MODE=true", "quran-mcp-server"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

프로덕션 모드(Node.js)

{
  "mcpServers": {
    "quran-api": {
      "command": "node",
      "args": ["/path/to/quran-mcp-server/dist/src/server.js"],
      "env": {
        "API_KEY": "your_api_key_if_needed",
        "VERBOSE_MODE": "true" // Set to "true" to enable verbose logging
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

개발 모드

{
  "mcpServers": {
    "quran-api": {
      "command": "npx",
      "args": ["ts-node", "/path/to/quran-mcp-server/src/server.ts"],
      "env": {
        "API_KEY": "your_api_key_if_needed",
        "VERBOSE_MODE": "true" // Set to "true" to enable verbose logging
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

중요 참고 사항:

/path/to/quran-mcp-server 시스템의 이 저장소에 대한 실제 경로로 바꾸십시오.
프로덕션 모드 구성을 사용하는 경우 먼저 npm run build 또는 docker build -t quran-mcp-server .
Quran.com API에서 필요한 경우 your_api_key_if_needed 실제 API 키로 바꾸세요.
이미 다른 MCP 서버가 구성되어 있는 경우 이 구성을 기존 mcpServers 개체에 추가하세요.
구성을 업데이트한 후 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

환경 변수

API_KEY : 인증을 위한 API 키
PORT : 서버 포트(기본값: 언어에 따라 8000 또는 3000)
VERBOSE_MODE : API 요청 및 응답에 대한 자세한 로깅을 활성화하려면 'true'로 설정합니다(기본값: false)

자세한 모드

VERBOSE_MODE 'true'로 설정하면 서버는 API 요청 및 응답에 대한 자세한 정보를 콘솔에 기록합니다. 이는 API 상호작용 디버깅 및 모니터링에 유용합니다.

자세한 로깅에는 다음이 포함됩니다.

요청 : 들어오는 각 요청에 대한 도구 이름과 인수를 기록합니다.
응답 : 각 응답에 대한 도구 이름과 결과 데이터를 기록합니다.
오류 : 오류 이름, 메시지, 스택 추적을 포함한 자세한 오류 정보를 기록합니다(사용 가능한 경우).

각 로그 항목에는 타임스탬프가 지정되고 로그 유형(요청, 응답 또는 오류)이 접두사로 붙어서 쉽게 식별할 수 있습니다.

테스트

# Run tests
npm test

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested