건틀릿-인셉트

학생들의 지식 수준과 관심사에 맞춰 고품질의 교육 콘텐츠를 생성하는 시스템입니다.

프로젝트 설명

이 저장소에는 K-8 학생들을 위한 고품질 교육 콘텐츠 생성 시스템 구축을 목표로 하는 Gauntlet-Incept 프로젝트의 코드와 리소스가 포함되어 있습니다. 초기 목표는 특정 과목 영역에 대한 논문 및 문제 은행 형태의 교육 콘텐츠 개발에 집중합니다.

선적 서류 비치

• 프로젝트 개요 - 프로젝트 목표 및 요구 사항에 대한 자세한 설명
• 구현 체크리스트 - 프로젝트 구현을 위한 포괄적인 체크리스트
• 원본 프로젝트 개요 - 자세한 요구 사항이 포함된 원본 프로젝트 개요
• MCP 서버 가이드 - Claude Desktop과 함께 Model Context Protocol 서버를 사용하기 위한 가이드

프로젝트 구조

지엑스피1

API 엔드포인트

이 프로젝트는 6개의 핵심 API 엔드포인트를 구현합니다.

질문 종료점

• POST /api/question/tag - 질문에 주제, 학년, 표준, 수업 및 난이도를 태그합니다.
• POST /api/question/grade - 태그가 지정된 질문을 품질 기준에 따라 평가합니다.
• POST /api/question/generate - 태그 또는 예시 질문을 기반으로 질문 생성

기사 엔드포인트

• POST /api/article/tag - 기사에 주제, 학년, 표준 및 수업을 태그합니다.
• POST /api/article/grade - 태그가 지정된 기사를 품질 기준에 따라 평가합니다.
• POST /api/article/generate - 태그 또는 예시 기사를 기반으로 기사 생성

모델 컨텍스트 프로토콜(MCP) 서버

REST API 외에도 이 프로젝트에는 Claude Desktop이 Gauntlet Incept 시스템과 상호 작용할 수 있도록 하는 MCP 서버가 포함되어 있습니다. 이를 통해 Claude는 교육 콘텐츠를 직접 생성하고, 태그를 지정하고, 채점할 수 있습니다.

Claude Desktop에서 MCP 서버를 설정하고 사용하는 방법에 대한 자세한 내용은 MCP 서버 가이드를 참조하세요.

시작하기

필수 조건

• 깃
• Node.js(v14 이상)
• RDS PostgreSQL 데이터베이스에 대한 액세스(관리자가 제공한 자격 증명)
• 데이터베이스 연결을 위한 SSH 키(SSH 터널을 통해 연결하는 경우)
• Docker 및 Docker Compose(컨테이너화된 배포의 경우 선택 사항)

설치

1. 저장소를 복제합니다
   git clone https://github.com/yourusername/Gauntlet-Incept.git
2. 프로젝트 디렉토리로 이동합니다
   cd Gauntlet-Incept
3. 종속성 설치
   npm install
4. 예제 환경 파일을 복사하고 원하는 값으로 업데이트하세요.
   cp .env.example .env
5. 프로젝트를 실행하세요
   npm start

Docker로 실행

1. 컨테이너를 빌드하고 시작하세요
   docker-compose up -d
2. http://localhost:3000 에서 API에 접속하세요
3. http://localhost:3001 에서 MCP 서버에 접속하세요

데이터베이스 연결

이 프로젝트는 다음 세부 정보를 사용하여 Amazon RDS PostgreSQL 인스턴스에 연결됩니다.

• 호스트 : alphacommoncrawl-core-reboot.cluster-caeuiwckzo1a.us-east-1.rds.amazonaws.com
• 포트 : 5432
• 데이터베이스 : 코어
• 사용자 이름 : postgres

참고: 보안상의 이유로 비밀번호는 코드에 직접 저장되는 것이 아니라 환경 변수에 저장됩니다.

SSH 터널을 통해 연결해야 하는 경우 애플리케이션을 시작하기 전에 별도로 터널을 설정해야 합니다.

개발

개발 모드에서 실행

MCP 서버 실행

테스트 실행

린팅

프로젝트 체크리스트

• [x] Git 저장소 초기화
• [x] 기본 프로젝트 구조 생성
• [x] .gitignore 파일 추가
• [x] 초기 커밋 생성
• [x] 프로젝트 문서 설정
• [x] 구현 체크리스트 생성
• [x] API 경로 및 서비스 구조 설정
• [x] 핵심 서비스에 대한 플레이스홀더 기능 구현
• [x] Docker 컨테이너화 설정
• [x] Claude Desktop 통합을 위한 MCP 서버 구현
• [x] RDS PostgreSQL 데이터베이스에 대한 연결 구성
• [ ] LLM 통합을 통한 실제 기능 구현
• [ ] 테스트 추가
• [ ] 검토 및 마무리

특허

MIT

연락하다

[연락처]