PeakMojo Server

PeakMojo 서버

PeakMojo API와 통합하기 위한 Python 서버 구현입니다.

특징

• PeakMojo API 엔드포인트와의 완벽한 통합
• 베어러 토큰 인증
• PeakMojo 기능에 대한 리소스 및 도구 기반 액세스
• 개발 중 모의 응답으로 자동 폴백

설치

지엑스피1

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• PEAKMOJO_API_KEY : 인증을 위한 PeakMojo API 키
• PEAKMOJO_BASE_URL (선택 사항): PeakMojo API 기본 URL(기본값은 https://api.staging.readymojo.com )

명령줄 인수를 통해 이를 구성할 수도 있습니다.

사용 가능한 리소스

이 서버는 다음 PeakMojo 리소스에 대한 액세스를 제공합니다.

• 사용자( peakmojo://users )
• 페르소나( peakmojo://personas , peakmojo://personas/tags , peakmojo://personas/search )
• 시나리오( peakmojo://scenarios )
• 작업 시나리오( peakmojo://job_scenarios )
• 채용정보 ( peakmojo://jobs )
• 애플리케이션( peakmojo://applications )
• 연습 ( peakmojo://practices )
• 기술( peakmojo://skills )
• 인증서( peakmojo://certificates )

사용 가능한 도구

서버는 PeakMojo API와 상호 작용하기 위한 다음과 같은 도구를 제공합니다.

사용자 관리

• get_peakmojo_users : 모든 사용자 목록을 가져옵니다
• get_peakmojo_user : ID로 사용자 세부 정보 가져오기
• get_peakmojo_user_stats : 사용자 통계 가져오기
• update_peakmojo_user_stats : 사용자 통계 업데이트

페르소나 관리

• get_peakmojo_personas : 페르소나 목록 가져오기
• get_peakmojo_persona_tags : 페르소나 태그 가져오기
• search_peakmojo_personas : 페르소나 검색
• create_peakmojo_persona : 새로운 페르소나를 만듭니다

시나리오 관리

• get_peakmojo_scenarios : 시나리오 목록 가져오기
• create_peakmojo_job_scenario : 새로운 작업 시나리오를 만듭니다.

작업 공간 관리

• get_workspace_personas : 작업 공간에 대한 페르소나를 가져옵니다.

작업 관리

• get_job : 작업 세부 정보 가져오기

애플리케이션 관리

• get_application : 애플리케이션 세부 정보 가져오기

실무 관리

• get_practice_messages : 연습 메시지 받기

기술 관리

• get_user_skills : 사용자 기술 가져오기

인증서 관리

• get_certificates : 인증서 목록을 가져옵니다
• get_certificate_skills : 인증서에 필요한 기술을 얻습니다.
• issue_user_certificate : 사용자에게 인증서를 발급합니다.
• add_certificate_skill_courses : 인증서 기술에 코스 추가

개발

개발 중에 API에 접근할 수 없는 경우, 서버는 자동으로 각 엔드포인트에 대한 모의 응답으로 대체됩니다. 이를 통해 라이브 API 연결 없이도 개발 및 테스트가 가능합니다.

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

• 잘못된 API 키는 경고와 함께 기록됩니다.
• 실패한 API 요청은 모의 응답으로 돌아갑니다.
• HTTP 오류가 제대로 포착되어 기록됩니다.
• 모든 오류는 적절한 오류 메시지와 함께 JSON 응답으로 반환됩니다.

도커 지원

필수 조건

Docker 이미지는 여러 플랫폼용으로 빌드되었습니다.

• 리눅스/amd64
• 리눅스/arm64
• 리눅스/arm/v7

옵션 1: Docker Hub에서 가져오기

옵션 2: 로컬로 빌드

컨테이너 실행

API 키를 사용한 기본 사용법:

크로스 플랫폼 퍼블리싱

여러 플랫폼에 대한 Docker 이미지를 게시하려면:

1. 새로운 빌더 인스턴스를 만듭니다(아직 만들지 않았다면):
   docker buildx create --use
2. 여러 플랫폼에 대한 이미지를 빌드하고 푸시합니다.
   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
3. 지정된 플랫폼에서 이미지를 사용할 수 있는지 확인하세요.
   docker buildx imagetools inspect peakmojo/mcp-server-peakmojo:latest

Claude Desktop과 함께 사용

Claude Desktop 설정에서 MCP 서버를 구성하세요.

소스에서 실행하는 예

소스 코드에서 직접 실행하려면:

기여하다

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