PeakMojo 서버

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

특징

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

설치

지엑스피1

구성

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

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

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

python -m mcp_server_peakmojo --api-key YOUR_API_KEY --base-url YOUR_BASE_URL

사용 가능한 리소스

이 서버는 다음 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에서 가져오기

docker pull buryhuang/mcp-server-peakmojo:latest

옵션 2: 로컬로 빌드

docker build -t mcp-server-peakmojo .

컨테이너 실행

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

docker run \
  -e PEAKMOJO_API_KEY=your_api_key_here \
  -e PEAKMOJO_BASE_URL=https://api.staging.readymojo.com \
  buryhuang/mcp-server-peakmojo:latest

크로스 플랫폼 퍼블리싱

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

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

Claude Desktop과 함께 사용

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

{
  "mcpServers": {
    "peakmojo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PEAKMOJO_API_KEY=your_api_key_here",
        "-e",
        "PEAKMOJO_BASE_URL=https://api.staging.readymojo.com",
        "peakmojo/mcp-server-peakmojo:latest"
      ]
    }
  }
}

소스에서 실행하는 예

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

{
  "mcpServers": {
    "peakmojo": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_peakmojo",
        "--api-key",
        "your_api_key_here",
        "--base-url",
        "https://api.staging.readymojo.com"
      ]
    }
  }
}

기여하다

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

PeakMojo Server

Integrations