MCP Server Fetch Python

by tatn

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables fetching content from JavaScript-rendered pages through a headless browser, making it possible to extract content from modern web applications and SPAs

  • Converts web page content to well-formatted Markdown while preserving structural elements like tables and definition lists

  • Leverages OpenAI's vision capabilities for AI-powered content extraction from media files (images and videos) when provided with an API key

mcp-server-fetch-python

웹 콘텐츠를 다양한 형식으로 가져오고 변환하는 MCP 서버입니다. 이 서버는 JavaScript로 렌더링된 콘텐츠 및 미디어 파일 지원을 포함하여 웹 페이지에서 콘텐츠를 추출하는 데 필요한 포괄적인 도구를 제공합니다.

특징

도구

서버는 4가지 전문 도구를 제공합니다.

  • get-raw-text : 브라우저 렌더링 없이 URL에서 직접 원시 텍스트 콘텐츠를 추출합니다.
    • 인수:
      • url : 대상 웹 페이지의 URL(text, JSON, XML, csv, tsv 등)(필수)
    • 구조화된 데이터 형식이나 빠르고 직접적인 액세스가 필요할 때 가장 잘 사용됩니다.
  • get-rendered-html : 헤드리스 브라우저를 사용하여 완전히 렌더링된 HTML 콘텐츠를 가져옵니다.
    • 인수:
      • url : 대상 웹페이지의 URL (필수)
    • JavaScript 렌더링이 필요한 최신 웹 애플리케이션 및 SPA에 필수적입니다.
  • get-markdown : 웹 페이지 콘텐츠를 잘 포맷된 마크다운으로 변환합니다.
    • 인수:
      • url : 대상 웹페이지의 URL (필수)
    • 구조적 요소를 보존하면서 깔끔하고 읽기 쉬운 텍스트 출력을 제공합니다.
  • get-markdown-from-media : 미디어 파일에서 AI 기반 콘텐츠 추출을 수행합니다.
    • 인수:
      • url : 대상 미디어 파일(이미지, 비디오)의 URL(필수)
    • 시각적 콘텐츠 분석을 위해 컴퓨터 비전과 OCR을 활용합니다.
    • 환경 변수에 유효한 OPENAI_API_KEY가 설정되어 있어야 합니다.
    • API 키가 설정되지 않았거나 미디어 파일을 처리하는 데 문제가 있는 경우 오류 메시지가 반환됩니다.

용법

클로드 데스크탑

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

지엑스피1

환경 변수

다음 환경 변수를 구성할 수 있습니다.

  • OPENAI_API_KEY : get-markdown-from-media 도구를 사용하는 데 필요합니다. 이 키는 AI 기반 이미지 분석 및 콘텐츠 추출에 필요합니다.
  • PYTHONIOENCODING : 출력에서 문자 인코딩 문제가 발생하면 "utf-8"로 설정합니다.
  • MODEL_NAME : 사용할 모델 이름을 지정합니다. 기본값은 "gpt-4o"입니다.
"mcpServers": { "mcp-server-fetch-python": { "command": "uvx", "args": [ "mcp-server-fetch-python" ], "env": { "OPENAI_API_KEY": "sk-****", "PYTHONIOENCODING": "utf-8", "MODEL_NAME": "gpt-4o", } } }

로컬 설치

또는 서버를 로컬로 설치하고 실행할 수 있습니다.

git clone https://github.com/tatn/mcp-server-fetch-python.git cd mcp-server-fetch-python uv sync uv build

그런 다음 Claude Desktop 구성 파일에 다음 구성을 추가합니다.

"mcpServers": { "mcp-server-fetch-python": { "command": "uv", "args": [ "--directory", "path\\to\\mcp-server-fetch-python", # Replace with actual path to the cloned repository "run", "mcp-server-fetch-python" ] } }

개발

디버깅

다음 명령을 사용하여 npx를 사용하여 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uvx mcp-server-fetch-python
npx @modelcontextprotocol/inspector uv --directory path\\to\\mcp-server-fetch-python run mcp-server-fetch-python

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

웹 콘텐츠를 가져와서 다양한 형식으로 변환하는 MCP 서버입니다.

  1. Features
    1. Tools
  2. Usage
    1. Claude Desktop
  3. Environment Variables
    1. Local Installation
  4. Development
    1. Debugging
ID: 8d0zm2o56d