링크된 문서
역링크
Fetch MCP 서버
Fetch MCP 서버
Fetch MCP 서버는 웹 콘텐츠 가져오기 기능을 제공하는 Model Context Protocol 서버입니다. 이 서버는 LLM이 웹 페이지에서 콘텐츠를 검색하고 처리할 수 있게 하며, HTML을 마크다운으로 변환하여 더 쉽게 소비할 수 있게 합니다.
주요 기능
웹 콘텐츠 가져오기
- 인터넷에서 URL을 가져와 콘텐츠를 마크다운으로 추출
- 대용량 웹 페이지도 효율적으로 처리 가능
청크 단위 읽기
start_index인자를 사용하여 콘텐츠 추출 시작 위치 지정 가능- 모델이 필요한 정보를 찾을 때까지 웹 페이지를 청크 단위로 읽을 수 있음
마크다운 변환
- HTML을 마크다운으로 변환하여 텍스트 기반 AI 모델이 쉽게 이해할 수 있게 함
- 필요 시 raw 콘텐츠도 가져올 수 있는 옵션 제공
도구
fetch
URL을 가져와 내용을 마크다운으로 추출합니다.
입력 매개변수:
- url (string, 필수): 가져올 URL
- max_length (integer, 선택 사항): 반환할 최대 문자 수 (기본값: 5000)
- start_index (integer, 선택 사항): 이 문자 인덱스부터 콘텐츠 시작 (기본값: 0)
- raw (boolean, 선택 사항): 마크다운 변환 없이 원시 콘텐츠 가져오기 (기본값: false)
설치 방법
선택 사항: 더 강력한 HTML 단순화 도구를 위해 Node.js를 설치할 수 있습니다.
uv 사용 (권장)
uv를 사용할 때는 특별한 설치가 필요 없습니다. uvx를 사용하여 mcp-server-fetch를 직접 실행할 수 있습니다.
PIP 사용
또는 pip를 통해 mcp-server-fetch를 설치할 수 있습니다:
pip install mcp-server-fetch설치 후 다음과 같이 스크립트로 실행할 수 있습니다:
python -m mcp_server_fetch구성 방법
Claude.app에서 사용하기
Claude 설정에 다음을 추가합니다:
uvx 사용
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}Docker 사용
{
"mcpServers": {
"fetch": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/fetch"]
}
}
}pip 설치 사용
{
"mcpServers": {
"fetch": {
"command": "python",
"args": ["-m", "mcp_server_fetch"]
}
}
}VS Code에서 사용하기
VS Code의 사용자 설정(JSON) 파일에 다음을 추가합니다:
uvx 사용
{
"mcp": {
"servers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
}Docker 사용
{
"mcp": {
"servers": {
"fetch": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/fetch"]
}
}
}
}커스터마이징
robots.txt 설정
기본적으로 서버는 모델(도구를 통해)에서 요청이 왔을 경우 웹사이트의 robots.txt 파일을 따르지만, 사용자가 시작한 요청(프롬프트를 통해)에는 따르지 않습니다. 이는 구성의 args 목록에 --ignore-robots-txt 인자를 추가하여 비활성화할 수 있습니다.
User-agent 설정
기본적으로 요청이 모델(도구를 통해)에서 왔는지 또는 사용자가 시작한 요청(프롬프트를 통해)인지에 따라 서버는 다음 사용자 에이전트 중 하나를 사용합니다:
- ModelContextProtocol/1.0 (Autonomous; +https://github.com/modelcontextprotocol/servers)
- ModelContextProtocol/1.0 (User-Specified; +https://github.com/modelcontextprotocol/servers)
이는 구성의 args 목록에 --user-agent=YourUserAgent 인자를 추가하여 사용자 정의할 수 있습니다.
프록시 설정
--proxy-url 인자를 사용하여 서버가 프록시를 사용하도록 구성할 수 있습니다.
디버깅
MCP 인스펙터를 사용하여 서버를 디버깅할 수 있습니다. uvx 설치의 경우:
npx @modelcontextprotocol/inspector uvx mcp-server-fetch또는 특정 디렉토리에 패키지를 설치했거나 개발 중인 경우:
cd path/to/servers/src/fetch
npx @modelcontextprotocol/inspector uv run mcp-server-fetch사용 사례
- 연구 및 분석: 웹 페이지에서 특정 정보를 추출하여 연구 또는 분석에 활용
- 콘텐츠 요약: 긴 웹 기사나 문서를 요약하여 핵심 내용 파악
- 데이터 수집: 여러 웹 사이트에서 구조화된 데이터 수집
- 정보 검증: 인터넷에서 사실과 정보를 확인
- 콘텐츠 통합: 다양한 소스의 정보를 하나의 문서로 통합
라이센스
mcp-server-fetch는 MIT 라이센스에 따라 라이센스가 부여됩니다. 이는 MIT 라이센스의 이용 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다.