Quran.com API용 MCP 서버

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

개요

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

Related MCP server: mcp-perplexity

엔드포인트

다음 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 기반 프로덕션 모드

프로덕션 모드(Node.js)

개발 모드

중요 참고 사항:

• /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 상호작용 디버깅 및 모니터링에 유용합니다.

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

• 요청 : 들어오는 각 요청에 대한 도구 이름과 인수를 기록합니다.

• 응답 : 각 응답에 대한 도구 이름과 결과 데이터를 기록합니다.

• 오류 : 오류 이름, 메시지, 스택 추적을 포함한 자세한 오류 정보를 기록합니다(사용 가능한 경우).

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

테스트

특허

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