Reach120 MCP server

MCP 서버로, AI 에이전트에게 Reach120 TOEFL iBT 연습 API에 대한 관리된 접근 경로를 제공합니다: Writing 연습 프롬프트를 가져오고, 학습자가 작성한 응답을 채점합니다.

Reach120은 독립적인 연습 플랫폼입니다. ETS와 제휴, 보증, 또는 관리 관계가 아닙니다. TOEFL®은 ETS의 등록 상표입니다. Reach120은 ETS와 제휴, 보증, 또는 승인 관계가 아닙니다.

도구

Related MCP server: agent-validator-mcp-server

키는 직접 준비하세요

이 서버는 자격 증명을 보유하지 않습니다. REACH120_API_KEY에 넣은 키를 전달하고 API의 응답을 변경 없이 반환합니다.

이는 누락이 아닌 설계 결정입니다. 중요한 모든 제한은 API 서버 측에 있으며 모든 호출에서 평가됩니다 — 키별 요청 창, 키별 일일 채점 허용량, 서비스 전체 지출 게이트입니다. 자체 제한을 적용하는 클라이언트는 해당 클라이언트를 계속 사용하기로 선택한 사람들에게만 제한을 적용할 뿐이므로, 이 서버는 어떤 제한도 적용하지 않으며 그 어떤 제한도 우회할 수 없습니다. 이 패키지를 삭제하고 엔드포인트를 직접 호출해도 동일한 거부 응답을 받습니다.

인증 없는 채점 경로는 없습니다. 키가 없는 에이전트는 키가 어디서 오는지 명시하는 거부 응답을 받으며, 아무것도 전송되지 않습니다.

키를 요청하고 전체 제한, 오류 코드 및 버전 정책은 https://www.reach120.com/developers 에서 확인하세요.

설치

이 패키지는 npm에 게시되지 않습니다. 설치 경로는 이 저장소이며, 유일한 경로입니다 — @reach120/mcp-server는 공개 npm 레지스트리에서 확인되지 않으며 다른 패키지 이름으로 대체되지 않습니다.

npx -y github:reach120/reach120-mcp

npm은 prepare 스크립트를 통해 해당 설치 중 TypeScript를 컴파일하므로 별도의 빌드 단계가 없습니다.

또는 클론하여 소스에서 실행할 수 있습니다:

git clone https://github.com/reach120/reach120-mcp.git
cd reach120-mcp
npm install
npm run build
node dist/index.js

구성

Claude Desktop(claude_desktop_config.json), Claude Code 또는 stdio를 지원하는 모든 MCP 클라이언트:

{
  "mcpServers": {
    "reach120": {
      "command": "npx",
      "args": ["-y", "github:reach120/reach120-mcp"],
      "env": {
        "REACH120_API_KEY": "r120_live_your_key_here"
      }
    }
  }
}

거부 응답의 형태

제한은 성능 저하 대신 기계가 읽을 수 있는 코드로 거부합니다. 키의 일일 허용량에 도달한 호출은 더 저렴한 엔진에서 조용히 채점되어 요청한 엔진인 것처럼 반환되지 않습니다 — 코드가 발생한 상황을 명시하며, /developers의 오류 표는 각 코드의 의미를 설명합니다.

로컬에서 검증하기

npm install
npm run build
npm run verify

npm run verify는 stdio를 통해 빌드된 서버를 시작하고, SDK 클라이언트와 실제 MCP 핸드셰이크를 완료하며, 공개된 도구를 출력하고, 키 없이 도구 하나를 호출하여 거부 경로를 보여줍니다.

점수는 연습 피드백입니다

score_writing_response는 Reach120이 생성한 자동 연습 피드백을 반환합니다.

ETS 점수가 아니며 공식 척도로 보고되지 않습니다. 이 README는 숫자가 속한 척도를 의도적으로 명시하지 않습니다: 해당 사실은 클레임 원장이 요구하는 필수 제한 사항과 함께 게시되며, 패키지 페이지에서는 표시할 수 없습니다. 응답 형식은 https://www.reach120.com/developers 에 문서화되어 있습니다.

TOEFL®은 ETS의 등록 상표입니다. Reach120은 ETS와 제휴, 보증, 또는 승인 관계가 아닙니다.

라이선스

MIT. LICENSE 참조.