Tool

What it answers

Example question

get-profile

Marcos Alvarez의 단일 프로필 레코드(이름, 헤드라인, 위치, 가용성, 짧은 소개)를 인용과 함께 하나의 객체로 반환합니다. '이 사람이 누구인지' 또는 '현재 가용성/위치가 무엇인지'를 한눈에 확인할 때 사용하세요. 역할별 업무 이력(이 경우 get-experience 사용), 특정 프로젝트 세부 정보(이 경우 search-projects 사용), 특정 스킬이나 기술이 명시되어 있는지 확인(이 경우 get-skill-evidence 사용)에는 사용하지 마세요. 입력값이 필요 없습니다. 정상 작동 시 '결과 없음'은 발생하지 않습니다 — 이 서버의 데이터셋에는 항상 정확히 하나의 프로필만 있습니다.

"Marcos Alvarez는 누구이며, 현재 새로운 역할에 열려 있나요?"

get-experience

선택적 구조화 필터(회사, 기술 태그, YYYY-MM 날짜 범위, 현재/과거 상태)와 일치하는 Marcos Alvarez의 업무 이력의 모든 항목을 최신순 목록으로 반환하며, 각 항목에 인용이 포함됩니다. 'X 회사에서 무엇을 했는지', 'Y 연도에 무엇을 작업했는지', '지금 무엇을 하고 있는지'에 답할 때 사용하세요. 필터 없이 호출하면 전체 이력을 반환합니다. 단일 프로필 요약(이 경우 get-profile 사용), 키워드로 프로젝트 설명 검색(이 경우 search-projects 사용), 특정 스킬이 명시되어 있는지 확인(이 경우 get-skill-evidence 사용)에는 사용하지 마세요. 어떤 역할과도 일치하지 않는 필터는 오류가 아니라 빈 목록과 함께 성공 결과를 반환합니다.

"Marcos는 2022년 이후 무엇을 작업했나요? 최근 역할을 설명해 주세요."

search-projects

키워드 및/또는 기술 태그로 Marcos Alvarez의 프로젝트 포트폴리오를 검색하고 관련성 점수, 일치 필드 설명, 인용이 포함된 순위 결과를 반환합니다. 일치는 프로젝트 이름, 요약, 본문, 기술 태그에 대한 결정적 키워드/태그 검색입니다 — 현재 쿼리에 대한 의미론적 또는 임베딩 기반 이해는 없습니다. 특정 프로젝트를 찾거나 설명하라는 요청(예: 'React를 사용한 프로젝트를 보여 줘' 또는 'Kubernetes로 무엇을 구축했는지')에 사용하세요. 연대순 업무 이력(이 경우 get-experience 사용)이나 스킬이 전혀 명시되어 있는지, 증거 또는 공백 확인(이 경우 get-skill-evidence 사용)에는 사용하지 마세요. 어떤 프로젝트와도 일치하지 않는 쿼리는 오류가 아니라 빈 목록과 함께 성공 결과를 반환합니다. 빈 쿼리나 공백만 있는 쿼리도 동일하게 동작합니다.

"Marcos가 TypeScript 또는 Kubernetes를 사용한 프로젝트를 보여 주세요."

get-skill-evidence

단일 명명된 스킬 또는 기술을 조회하고 세 가지 정직한 결과 중 하나를 보고합니다: 'claimed'(지원 증거가 있는 스킬), 'not-claimed'(자체 설명과 관련 스킬이 있는 명시적이고 인정된 공백), 또는 'unknown'(어느 쪽과도 일치하지 않는 용어). 특정 기술에 대해 'X를 아는지' 또는 'Y로 작업한 적이 있는지' 질문받을 때 사용하세요. 전체 스킬 목록을 탐색하거나(이 서버에는 그런 도구가 없음) 키워드로 프로젝트 설명을 검색하는 데는 사용하지 마세요(대신 search-projects 사용). 질문이 단일 스킬이 아닌 역할이나 회사에 관한 것일 때 get-experience를 대체하지도 않습니다. 'not-claimed' 또는 'unknown' 결과는 오류가 아니라 정상적이고 성공적인 답변입니다 — 재시도하거나 그 주변을 지어내지 말고 정직하게 전달하세요.

"Marcos가 이벤트 기반 아키텍처로 작업한 적이 있나요? 증거를 보여 주세요."

search-career

Marcos Alvarez의 경력 콘텐츠(경력, 프로젝트, 스킬, 글) 전체 텍스트에 대해 퍼지(fuzzy) 의미론적 검색을 실행하고 관련성 점수와 인용이 포함된 순위 발췌문을 반환하거나, 유사도 임계값을 넘는 내용이 없을 때 명시적 '관련 콘텐츠 없음' 결과를 반환합니다. 구조화된 조회로 직접 답할 수 없는 개방형, 교차 주제, 또는 개념적 질문에 사용하세요 — 예: '이벤트 기반 아키텍처로 작업한 적이 있는지', '팀 리딩 경험이 어떤지', '비용 최적화에 관한 것'. 질문이 결정적 도구가 이미 정확히 답하는 특정 구조화 조회에 매핑될 때는 사용하지 마세요: 그가 누구인지는 get-profile, 역할/회사/날짜 범위 업무 이력은 get-experience, 키워드/태그 프로젝트 검색은 search-projects, 특정 명명된 스킬 또는 기술 확인은 get-skill-evidence — 이들을 먼저 선호하고, 맞지 않을 때만 이 도구로 폴백하세요. 이 도구는 호출당 비용이 더 높고(쿼리를 임베딩함) 여기의 다른 모든 도구와 동일한 서버 전체 속도 제한이 적용됩니다 — 같은 질문에 반복 호출하지 마세요.

"엔지니어링 팀 리딩과 멘토링에 대한 Marcos의 경험은 어떤가요?"

변수

용도

SITE_URL

사이트 자체 절대 출처(origin)에 대한 선택적 재정의. 필수 아님 — Vercel이 자동으로 파생합니다.

UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN

/api/mcp 속도 제한을 지원하는 Upstash Redis 자격 증명. 설정하지 않으면 오류 대신 열린 상태(제한 없음)로 실패합니다.

RATELIMIT_MAX_REQUESTS, RATELIMIT_WINDOW_SECONDS

MCP 엔드포인트의 속도 제한 창을 재정의합니다.

CHAT_PROVIDER, CHAT_MODEL_ID

채팅 에이전트의 모델 제공자/ID를 선택하고 고정합니다.

GOOGLE_GENERATIVE_AI_API_KEY

CHAT_PROVIDER=google(기본값)일 때 필요합니다.

ANTHROPIC_API_KEY

CHAT_PROVIDER=anthropic일 때만 필요합니다.

CHAT_SESSION_RATELIMIT_MAX_REQUESTS, CHAT_SESSION_RATELIMIT_WINDOW_SECONDS, CHAT_IP_RATELIMIT_MAX_REQUESTS, CHAT_IP_RATELIMIT_WINDOW_SECONDS, CHAT_AGENT_MAX_STEPS

채팅 가드레일 튜닝 — apps/web/README.md의 "Chat guardrails" 참조.

DATABASE_URL

@hire-me-mcp/core/db 모듈용 Neon Postgres 연결 문자열(마이그레이션, 수집, searchCareer). packages/core/README.md 참조.

NEON_API_KEY, NEON_PROJECT_ID

DB 통합 테스트 스위트 전용 임시 Neon 브랜치 생성/삭제 — 메인 데이터베이스에는 절대 사용되지 않습니다.