ref-tools/ref-tools-mcp

어떤 프로젝트인가요?

핵심 기능

• 01하나의 검색 도구로 공개 웹, GitHub 및 비공개 문서 소스를 검색합니다.
• 02같은 세션에서 앞서 반환한 결과는 건너뛰어 중복을 방지합니다.
• 03URL을 Markdown으로 변환하고 가장 관련성 높은 섹션만 남깁니다.
• 04streamable-http와 로컬 stdio 연결 방식을 모두 제공합니다.
• 05OpenAI deep research와 호환되는 도구 이름을 제공합니다.

활용 사례

• 통합 코드를 작성하는 동안 코딩 에이전트가 최신 API 엔드포인트를 조회하도록 합니다.
• 에이전트가 비공개 내부 라이브러리 문서나 저장소에 접근할 수 있게 합니다.
• 에이전트가 긴 문서 페이지를 읽을 때 토큰 비용과 불필요한 정보를 줄입니다.

빠른 시작

1. 1

   ref.tools에 가입해 API 키를 발급받으세요

2. 2

   stdio 서버를 MCP 클라이언트 설정에 추가하고 REF_API_KEY를 설정한 뒤 npx로 실행하세요

   npx ref-tools-mcp@latest

사용 전 알아둘 점

• !ref.tools에 가입해 발급받은 Ref API 키가 필요합니다.
• !이 저장소에는 레거시 stdio 서버가 포함되어 있습니다. README에서는 대신 호스팅된 streamable-http 서버를 권장합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ref-tools-mcp은(는) 무엇인가요?

AI 코딩 에이전트가 공개 및 비공개 라이브러리 문서를 토큰 효율적으로 이용할 수 있게 해주는 MCP 서버입니다. Ref MCP는 AI 코딩 도구와 에이전트가 API, 서비스, 라이브러리 문서를 검색하고 읽을 수 있게 해주는 Model Context Protocol 서버입니다. 전체 문장으로 검색어를 입력하면 공개 웹 페이지, GitHub, 저장소나 PDF 같은 비공개 리소스에서 관련 결과를 반환하는 검색 도구와, URL을 가져와 Markdown으로 변환하는 읽기 도구를 제공합니다.

ref-tools-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ref-tools-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ref-tools-mcp은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ref-tools-mcp의 마지막 커밋은 2026년 11월 6일입니다.

ref-tools-mcp은(는) 어디에 사용할 수 있나요?

통합 코드를 작성하는 동안 코딩 에이전트가 최신 API 엔드포인트를 조회하도록 합니다. 에이전트가 비공개 내부 라이브러리 문서나 저장소에 접근할 수 있게 합니다. 에이전트가 긴 문서 페이지를 읽을 때 토큰 비용과 불필요한 정보를 줄입니다.

ref-tools-mcp는 어떻게 설치하나요?

ref.tools에 가입해 API 키를 발급받으세요 stdio 서버를 MCP 클라이언트 설정에 추가하고 REF_API_KEY를 설정한 뒤 npx로 실행하세요: npx ref-tools-mcp@latest

ref-tools-mcp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ref-tools/ref-tools-mcp