🧬 연구 허브

환경

다른 컴퓨터에서
시작하기

무엇을 하려느냐에 따라 필요한 게 다릅니다. 위에서 아래로 갈수록 준비할 게 많아집니다.

1 · Skill 만 쓰고 싶다

가장 흔한 경우입니다. Claude Code 만 깔려 있으면 됩니다.

curl -O https://research-hub-9xr.pages.dev/downloads/install-skills.sh
sh install-skills.sh

~/.claude/skills/ 에 9개가 설치됩니다. 이 중 7개는 파이썬 스크립트를 포함하는데, 쓰려면 python3pandas(엑셀을 다루는 것만) 가 필요합니다.

pip3 install pandas openpyxl   # excel-case-validator 를 쓸 때만

설치 후 Claude Code 를 다시 시작하면 인식됩니다.

2 · 같은 Claude Code 환경을 만들고 싶다

Skill 외에 플러그인과 MCP 서버까지 맞추는 경우입니다.

플러그인

/plugin marketplace add anthropics/claude-plugins-official
/plugin marketplace add popup-studio-ai/bkit-claude-code
/plugin marketplace add DietrichGebert/ponytail

/plugin install superpowers        # 브레인스토밍·계획·체계적 디버깅
/plugin install code-review        # PR·diff 리뷰
/plugin install frontend-design    # UI 디자인
/plugin install bkit               # PDCA 워크플로
/plugin install ponytail           # 최소 구현 강제

MCP 서버

이름범위준비
context7전역라이브러리 최신 문서. 설정 없이 추가만 하면 됨
playwright전역브라우저 자동화. 첫 실행 시 브라우저를 내려받음
claude-in-chrome전역Chrome 확장 설치 + claude.ai 로그인 필요
obsidian-mcp-connector프로젝트Obsidian 볼트 경로가 그 컴퓨터에 있어야 함
mcp-tools-istefox프로젝트localhost 서버 + 토큰. 토큰은 이 사이트에 없습니다 — 해당 프로젝트의 .mcp.json 을 직접 복사하세요

토큰·API 키는 사이트에 싣지 않습니다. 사람을 통해 직접 전달하세요.

3 · 이 사이트를 고치고 배포하고 싶다

사이트 소스는 ~/Documents/data_catalog/ 에 있습니다.

python3 -m pip install fonttools brotli   # 폰트 서브셋용
npm i -g wrangler                        # 또는 npx 로 사용
npx wrangler login                       # Cloudflare 계정 연결

python3 build.py                                            # site/ 재생성
npx wrangler pages deploy site --project-name=research-hub  # 배포

필요한 것: python3, fonttools+brotli, wrangler, Cloudflare 계정, 그리고 vendor/ 안의 Pretendard 원본(2.2MB). Skill 본문은 그 컴퓨터의 ~/.claude/skills/ 를 읽어 만듭니다 — 먼저 1번을 해두세요.

4 · 프로젝트 코드를 가져오고 싶다

여기서 막힙니다. 솔직하게 적습니다.

프로젝트다른 컴퓨터에서 받을 수 있나
IMOK/CRC-TNM-Agents 가능 — git clone https://github.com/Core-BMC/CRC-TNM-Agents.git
그 외 전부 불가. git 원격이 없어 이 컴퓨터에만 있습니다. 외장 디스크나 직접 전송 외에는 방법이 없습니다

Skill 의 “정본 코드” 경로가 가리키는 파일들이 대부분 여기 해당합니다. 받아둔 Skill 문서는 설계와 함정을 알려주지만, 원본 코드를 돌려보려면 그 프로젝트를 따로 옮겨야 합니다.

저장소를 만들어 올려두면 이 문제가 사라집니다. 어디까지 올릴지는 환자 데이터 포함 여부를 따져야 해서 사람이 정할 일입니다.

5 · 외부 API — 무엇을 쓰고 키는 어디서 받나

API호스트쓰는 Skill
공공데이터포털 — 임상시험 상세apis.data.go.kr/1471000/ClncExamPlanDtlService2data.go.kr 에서 발급 · 무료ctrial-collect
식약처 의약품안전나라(nedrug)nedrug.mfds.go.kr일부 공개 · 상세는 data.go.kr 키regimen-extract
PubMed E-utilitieseutils.ncbi.nlm.nih.gov키 없이 가능 · 키 등록 시 초당 한도 상향lit-relevance-classify
CrossRef REST APIapi.crossref.org키 불필요 · mailto 넣으면 ~50 req/slit-relevance-classify
OpenAlexapi.openalex.org키 불필요lit-relevance-classify

6 · 내부 자원

주소와 키는 이 사이트에 싣지 않습니다. 공개 URL 이라 병원망 주소를 올릴 수 없습니다. 무엇이 있고 설정이 어디 있는지만 적습니다.

자원무엇설정 위치
온프렘 Ollama 서버병원망 안의 LLM 추론 서버. 여러 대를 round-robin 으로 쓴다.주소는 각 프로젝트의 .env / config 에 있음
Azure OpenAI 전용 배포병원 계약 배포. 온프렘으로 안 되는 정확도가 필요할 때.엔드포인트·키는 .env (AZURE_OPENAI_*)
Elasticsearch임상시험 색인. 선택 단계라 없어도 수집·비교는 돈다.ctrial-auto_4월/app/services/elasticsearch_service.py
Cloudflare D1허초프로젝트의 검토상태 공용 저장소.허초프로젝트/wrangler.toml
MfdsUpdater2식약처 갱신용 외부 Gradle 프로젝트. subprocess 로 호출된다.ctrial-auto_4월 과 나란히 있어야 함

7 · 환경변수 이름

새 컴퓨터에서 .env 를 채울 때 필요한 항목입니다. 이름만 적습니다.

LLM

  • AZURE_OPENAI_API_KEY
  • AZURE_OPENAI_ENDPOINT
  • AZURE_OPENAI_DEPLOYMENT
  • AZURE_OPENAI_API_VERSION
  • OLLAMA_HOST

임상시험 수집

  • CLINICAL_TRIAL_API_KEY
  • CLINICAL_TRIAL_API_URL
  • API_NUM_OF_ROWS
  • API_CALL_DELAY
  • API_MAX_RETRIES

프로젝트에 sample.envenv.example 이 있으면 그걸 복사해 채우는 게 가장 빠릅니다.