MonkeyType MCP 서버

MonkeyType API 의 모든 엔드포인트에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 대규모 언어 모델(LLM)이 MonkeyType API와 상호 작용할 수 있도록 하는 MCP 도구를 제공합니다.

특징

모든 MonkeyType API 엔드포인트를 MCP 도구로 노출합니다.
모델 컨텍스트 프로토콜을 지원하는 모든 LLM과 호환 가능
도구 호출당 간단한 API 키 기반 인증
포괄적인 오류 처리
속도 제한 인식(MonkeyType의 속도 제한을 존중함)

설치

npx 사용(권장)

서버를 실행하는 가장 쉬운 방법은 npx를 사용하는 것입니다.

지엑스피1

이렇게 하면 최신 버전의 서버가 직접 다운로드되어 실행됩니다.

글로벌 설치

또한 패키지를 글로벌하게 설치할 수도 있습니다.

npm install -g monkeytype-mcp
monkeytype-mcp

수동 설치

저장소를 복제하려면 다음을 수행하세요.

git clone https://github.com/CodeDreamer06/MonkeytypeMCP.git
cd MonkeytypeMCP
npm install
npm start

사용 가능한 도구

서버는 다음 MonkeyType API 엔드포인트를 MCP 도구로 노출합니다.

사용자 도구

check_username - 사용자 이름이 사용 가능한지 확인
get_personal_bests - 사용자의 개인 최고 기록을 가져옵니다.
get_tags - 사용자의 태그 가져오기
get_stats - 사용자 통계 가져오기
get_profile - 사용자 프로필 가져오기
send_forgot_password_email - 비밀번호를 잊어버린 경우 이메일 보내기
get_current_test_activity - 현재 테스트 활동 가져오기
get_streak - 사용자의 연속 기록 가져오기

테스트 결과 도구

get_results - 최대 1000개의 테스트 결과를 가져옵니다.
get_result_by_id - ID로 결과 가져오기
get_last_result - 마지막 결과 가져오기

공공 도구

get_speed_histogram - 속도 히스토그램 가져오기
get_typing_stats - 타이핑 통계 가져오기

리더보드 도구

get_leaderboard - 리더보드 가져오기
get_leaderboard_rank - 리더보드 순위를 가져옵니다
get_daily_leaderboard - 매일 리더보드 받기
get_weekly_xp_leaderboard - 주간 XP 리더보드 받기

공익광고 도구

get_psas - 공익광고(PSA) 받기

견적 도구

is_submission_enabled - 견적 제출이 활성화되어 있는지 확인합니다.

서버 구성 도구

get_configuration - 서버 구성 가져오기

MonkeyType API 키(ApeKey)를 얻는 방법

MonkeyType API 키(ApeKey)를 얻으려면 다음 단계를 따르세요.

MonkeyType 계정에 로그인하세요
오른쪽 상단 모서리에 있는 프로필 아이콘을 클릭하세요
드롭다운 메뉴에서 "계정"을 선택하세요
"Ape Keys" 탭으로 이동합니다.
새 API 키를 생성하려면 "새로 생성"을 클릭하세요.
키에 이름을 지정하세요(예: "MCP 서버")
액세스해야 하는 엔드포인트에 따라 적절한 범위를 선택하세요.
"생성"을 클릭하세요
생성된 키를 복사하세요

중요 : API 키를 안전하게 보관하고 절대로 공개적으로 공유하지 마세요.

LLM과 함께 MCP 서버 사용

이 서버를 LLM과 함께 사용하려면 MCP 도구 호출에 이 서버를 사용하도록 LLM을 구성해야 합니다. MCP 서버 구성에서 MONKEYTYPE_API_KEY 환경 변수를 설정하여 MonkeyType API 키(ApeKey)를 제공해야 합니다.

환경 변수

MONKEYTYPE_API_KEY : (필수) MonkeyType API 키입니다. monkeytype.com의 계정 설정에서 확인할 수 있습니다.
MONKEYTYPE_USERNAME : (선택 사항) MonkeyType 사용자 이름 또는 UID입니다. 특정 도구(예: get_profile )에서 기본값으로 사용하거나 특정 키워드를 사용할 때 사용할 수 있습니다.

예제 도구 호출

{
  "name": "get_configuration",
  "arguments": {}
}

LLM 플랫폼과의 통합

이 서버를 OpenAI, Anthropic 또는 기타 LLM 플랫폼과 통합하려면:

위의 설치 방법 중 하나를 사용하여 MCP 서버를 시작하세요.
이 서버를 MCP 도구 공급자로 사용하도록 LLM 플랫폼을 구성하세요.
서버의 stdio를 통신 채널로 전달합니다.

IDE 통합

MCP 구성

IDE에 MonkeyType MCP를 추가하려면 IDE의 MCP 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "monkeytype": {
      "command": "sh",
      "args": ["-c", "cd $(mktemp -d) && npm install monkeytype-mcp && npx monkeytype-mcp"],
      "env": {
        "MONKEYTYPE_API_KEY": "YOUR_APE_KEY_HERE"
      }
    }
  }
}

구성 파일 위치:

커서: ~/.cursor/mcp.json
윈드서핑: ~/.codeium/windsurf/mcp_config.json
클라인: ~/.cline/mcp_config.json
클로드: ~/.claude/mcp_config.json

VS 코드 통합

VS Code에서 이 MCP 서버를 사용하려면:

VS Code 설정 열기
"MCP 서버"를 검색하세요
다음 구성으로 새로운 MCP 서버를 추가합니다.
- 이름: MonkeyType MCP
- 명령어: npx monkeytype-mcp
- 유형: 표준 입출력(stdio)

사용 가능한 도구

서버는 다음 MonkeyType API 엔드포인트를 MCP 도구로 노출합니다.

사용자 도구

check_username - 사용자 이름이 사용 가능한지 확인
get_personal_bests - 사용자의 개인 최고 기록을 가져옵니다.
get_tags - 사용자의 태그 가져오기
get_stats - 사용자 통계 가져오기
get_profile - 사용자 프로필 가져오기
send_forgot_password_email - 비밀번호를 잊어버린 경우 이메일 보내기
get_current_test_activity - 현재 테스트 활동 가져오기
get_streak - 사용자의 연속 기록 가져오기

`get_profile`

사용자의 공개 프로필을 가져옵니다.

매개변수:

uidOrName (문자열, 선택 사항): 프로필을 가져올 사용자의 UID 또는 사용자 이름입니다.
- 특정 사용자 이름이나 UID를 제공하면 해당 사용자의 프로필이 가져와집니다.
- "me", "self", "current", "my"와 같은 키워드를 사용할 수 있습니다. 이러한 키워드 중 하나를 사용하면 도구는 MONKEYTYPE_USERNAME 환경 변수(설정된 경우)를 사용합니다.
- 이 매개변수를 완전히 생략하면 도구는 MONKEYTYPE_USERNAME 환경 변수(설정된 경우)를 사용하려고 시도합니다.
- uidOrName 매개변수가 생략되거나 키워드가 사용되고 MONKEYTYPE_USERNAME 환경 변수가 설정되지 않은 경우 오류가 발생합니다.

테스트 결과 도구

get_results - 최대 1000개의 테스트 결과를 가져옵니다.
get_result_by_id - ID로 결과 가져오기
get_last_result - 마지막 결과 가져오기

공공 도구

get_speed_histogram - 속도 히스토그램 가져오기
get_typing_stats - 타이핑 통계 가져오기

리더보드 도구

get_leaderboard - 리더보드 가져오기
get_leaderboard_rank - 리더보드 순위를 가져옵니다
get_daily_leaderboard - 매일 리더보드 받기
get_weekly_xp_leaderboard - 주간 XP 리더보드 받기

공익광고 도구

get_psas - 공익광고(PSA) 받기

견적 도구

is_submission_enabled - 견적 제출이 활성화되어 있는지 확인합니다.

서버 구성 도구

get_configuration - 서버 구성 가져오기

출판

이 서버를 변경하고 자신의 버전을 게시하려면 다음을 수행하세요.

npm login
npm publish

GitHub 저장소

이 프로젝트는 https://github.com/CodeDreamer06/MonkeytypeMCP 의 GitHub에 호스팅되었습니다.

특허

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

감사의 말

API를 제공해 주신 MonkeyType 에게 감사드립니다.
서버 아키텍처를 위한 모델 컨텍스트 프로토콜(MCP)

부인 성명

이 프로젝트는 MonkeyType과 공식적으로 제휴 관계가 없습니다. 사용 시 발생하는 모든 책임은 사용자에게 있으며, MonkeyType의 서비스 약관 및 API 속도 제한을 준수해야 합니다.

Integrations