말레이시아 기도 시간 MCP 서버

개요

말레이시아 기도 시간 MCP 서버는 말레이시아 전역의 정확한 이슬람 기도 시간을 제공합니다. 이 서버는 Claude Desktop과 완벽하게 통합되는 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 비서를 통해 실시간 기도 일정을 직접 제공합니다.

이 서버는 waktusolat.app API를 활용하여 JAKIM에서 검증한 기도 시간을 검색하고 도시, 지역 코드 또는 좌표로 검색하는 기능을 지원합니다.

특징

✅ 위치 기반 시간 : 말레이시아의 모든 도시 또는 지역의 기도 시간을 받으세요
✅ 좌표 지원 : 위도와 경도 좌표를 사용하여 기도 시간을 찾으세요
✅ 지역 코드 접근 : JAKIM 지역 코드를 사용하여 직접 쿼리합니다(예: 쿠알라룸푸르의 경우 SGR03 ).
✅ 기도 일정 완료 : 매일의 모든 기도 시간(파즈르, 일출, 두르, 아스르, 마그리브, 이샤)을 검색합니다.
✅ 현재 기도 상태 : 현재 및 다음 기도 시간을 확인하세요
✅ 강력한 오류 처리 : 네트워크 문제 및 API 변경 사항을 우아하게 처리합니다.
✅ Claude Desktop과의 원활한 통합 : MCP를 통한 Claude Desktop과의 깔끔한 통합

설치

필수 조건

Python 3.10 이상
클로드 데스크탑(최신 버전)
pip 또는 uv 패키지 관리자

옵션 1: GitHub에서 설치

지엑스피1

옵션 2: uv 사용(권장)

# Clone the repository
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# Create and activate a virtual environment using uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

구성

Claude Desktop 구성

Claude Desktop 구성 파일을 생성하거나 편집합니다.

맥OS :

mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

윈도우 :

mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가합니다(설정에 따라 경로를 조정합니다):

{
    "mcpServers": {
        "malaysia-prayer-time": {
            "command": "/absolute/path/to/your/.venv/bin/python",
            "args": [
                "main.py"
            ],
            "cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time"
        }
    }
}

Claude Desktop을 완전히 다시 시작하세요

용법

구성이 완료되면 Claude Desktop에서 자연어 쿼리를 사용하여 기도 시간과 상호 작용할 수 있습니다.

예시

도시/지역별 기도 시간 받기

"오늘 쿠알라룸푸르의 기도 시간은 언제인가요?"
"말레이시아 이포의 기도 시간을 보여주세요"
"PRK02를 위한 기도 시간을 받으세요"(지역번호 사용)

좌표별 기도 시간 받기

"좌표 3.1390, 101.6869의 기도 시간은 언제입니까?"
"위치 5.4141, 100.3288의 기도 일정을 보여주세요"

사용 가능한 영역 나열

"말레이시아의 모든 기도 시간대를 나열하세요"
"사용 가능한 모든 JAKIM 지역 코드를 보여주세요"

API 참조

사용 가능한 도구

MCP 서버는 Claude에게 다음 도구를 제공합니다.

`get_prayer_times`

말레이시아의 특정 도시나 지역 코드에 대한 기도시간을 검색합니다.

매개변수 :

city (문자열, 기본값: "kuala lumpur"): 도시 이름 또는 지역 코드(예: "SGR03")
country (문자열, 기본값: "말레이시아"): 현재 "말레이시아"만 지원합니다.
date (문자열, 기본값: "today"): YYYY-MM-DD 형식 또는 "today" 날짜

`get_prayer_times_by_coordinates`

지리적 좌표를 기반으로 기도 시간을 검색합니다.

매개변수 :

latitude (float): 위도 좌표
longitude (float): 경도 좌표
date (문자열, 기본값: "today"): YYYY-MM-DD 형식 또는 "today" 날짜

`list_zones`

말레이시아에서 사용 가능한 모든 기도 시간대와 해당 코드를 나열합니다.

기도 시간 정보

서버는 다음과 같은 기도시간을 제공합니다:

임삭(새벽 식사 시간, 가능하다면)
파즈르(새벽기도)
시루크/일출
두르(정오기도)
아스르(오후 기도)
마그리브(일몰기도)
이샤(야간기도)

존 커버리지

이 서버는 현재 말레이시아의 모든 JAKIM 구역을 지원합니다. 좌표 기반 조회는 다음과 같은 주요 지역을 지원합니다.

쿠알라룸푸르/셀랑고르: SGR01-SGR04
페락: PRK01-PRK04
페낭: PNG01
조호르: JHR01
케다: KDH01
트렝가누: TRG01
켈란탄: KTN01
멜라카: MLK01

문제 해결

일반적인 문제

Claude가 서버에 연결할 수 없습니다

구성 경로가 절대적이고 올바른지 확인하세요
클로드 로그 확인:
# macOS tail -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
서버를 직접 테스트하세요:
cd /path/to/mcp-server-malaysia-prayer-time python main.py

기도 시간이 없습니다

인터넷 연결 확인
지역 코드가 유효한지 확인하세요( list_zones 사용)
API를 일시적으로 사용할 수 없을 수 있습니다. 나중에 다시 시도하세요.

도시를 찾을 수 없습니다

다른 철자법, 인근 주요 도시 또는 적절한 지역 코드를 사용해 보세요.

기여하다

참여를 환영합니다! 참여 방법은 다음과 같습니다.

저장소를 포크하세요
기능 브랜치를 생성합니다: git checkout -b feature/amazing-feature
변경 사항을 커밋하세요: git commit -m 'Add some amazing feature'
브랜치에 푸시: git push origin feature/amazing-feature
풀 리퀘스트 열기

개발 설정

# Clone your fork
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# Set up development environment
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"  # Installs dev dependencies

# Run tests
pytest

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

waktusolat.app - 기도 시간 데이터 API 제공
모델 컨텍스트 프로토콜 - MCP 프레임워크용
JAKIM - 공식 기도 시간을 위해
Claude Desktop - AI 통합 플랫폼용