MCP URL 형식 변환기

모든 URL에서 콘텐츠를 가져와 원하는 출력 형식으로 변환하는 MCP(Model Context Protocol) 서버입니다.

개요

MCP URL 형식 변환기는 모든 웹 URL에서 콘텐츠를 검색하여 원본 콘텐츠 유형에 관계없이 다양한 형식(HTML, JSON, 마크다운 또는 일반 텍스트)으로 변환하는 도구를 제공합니다. Claude for Desktop을 포함한 모든 MCP 호환 클라이언트와 호환되도록 설계되어 LLM이 일관된 형식으로 웹 콘텐츠에 액세스하고, 변환하고, 분석할 수 있도록 지원합니다.

특징

• 🔄 형식 변환 : 모든 웹 콘텐츠를 HTML, JSON, 마크다운 또는 일반 텍스트로 변환합니다.
• 🌐 범용 입력 지원 : 웹사이트, API, 원시 파일 등을 처리합니다.
• 🔍 자동 콘텐츠 감지 : 소스 형식을 지능적으로 식별합니다.
• 🧰 강력한 라이브러리 지원 : 업계 표준 라이브러리 사용:
  • HTML 파싱에 대한 Cheerio
  • 마크다운 처리를 위해 표시됨
  • XML 처리를 위한 Fast-XML-Parser
  • CSV 변환을 위한 CSVtoJSON
  • 보안을 위한 HTML Sanitize
  • HTML-마크다운 변환에 대한 턴다운
• 🔧 고급 포맷 처리 :
  • 메타데이터 추출을 통한 HTML 구문 분석
  • JSON 예쁘게 인쇄 및 구조 보존
  • 스타일링을 통한 마크다운 렌더링
  • CSV-테이블 변환
  • XML-JSON 변환
• 📜 기록 추적 : 최근에 가져온 URL의 로그를 유지합니다.
• 🛡️ 보안 초점 : XSS 공격을 방지하기 위한 콘텐츠 정리

설치

필수 조건

• Node.js 16.x 이상
• npm 또는 yarn

빠른 시작

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. 프로젝트를 빌드하세요:
   npm run build
4. 서버를 실행합니다:
   npm start

데스크톱용 Claude와 통합

1. Claude for Desktop 구성 파일을 엽니다.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 구성에 URL 변환 서버를 추가합니다.
   { "mcpServers": { "url-converter": { "command": "node", "args": ["/absolute/path/to/mcp-url-converter/build/index.js"] } } }
3. 데스크톱용 Claude를 다시 시작하세요

사용 가능한 도구

fetch

모든 URL에서 콘텐츠를 가져와 가장 적합한 출력 형식을 자동으로 감지합니다.

매개변수:

• url (문자열, 필수): 콘텐츠를 가져올 URL
• format (문자열, 선택 사항): 변환할 형식( auto , html , json , markdown , text ). 기본값: auto

예:

fetch-json

모든 URL에서 콘텐츠를 가져와 JSON 형식으로 변환합니다.

매개변수:

• url (문자열, 필수): 콘텐츠를 가져올 URL
• prettyPrint (부울, 선택 사항): JSON을 예쁘게 인쇄할지 여부입니다. 기본값: true

예:

fetch-html

모든 URL에서 콘텐츠를 가져와 HTML 형식으로 변환합니다.

매개변수:

• url (문자열, 필수): 콘텐츠를 가져올 URL
• extractText (부울, 선택 사항): 텍스트 콘텐츠만 추출할지 여부입니다. 기본값: false

예:

fetch-markdown

모든 URL에서 콘텐츠를 가져와 마크다운 형식으로 변환합니다.

매개변수:

• url (문자열, 필수): 콘텐츠를 가져올 URL

예:

fetch-text

모든 URL에서 콘텐츠를 가져와 일반 텍스트 형식으로 변환합니다.

매개변수:

• url (문자열, 필수): 콘텐츠를 가져올 URL

예:

web-search 및 deep-research

이러한 도구는 Perplexity 검색 기능에 대한 인터페이스를 제공합니다(MCP 호스트에서 지원하는 경우).

사용 가능한 리소스

recent-urls://list

최근 가져온 URL 목록을 타임스탬프와 출력 형식과 함께 반환합니다.

예:

보안

이 서버는 여러 가지 보안 조치를 구현하고 있습니다.

• XSS 공격을 방지하기 위해 sanitize-html 사용한 HTML 정리
• 처리 전 콘텐츠 검증
• 오류 처리 및 안전한 기본값
• Zod를 사용한 입력 매개변수 검증
• 안전한 출력 인코딩

테스트

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

문제 해결

일반적인 문제

1. 연결 오류 : URL이 접근 가능하고 올바르게 형식화되었는지 확인하세요.
2. 변환 오류 : 일부 복잡한 콘텐츠는 형식 간에 깔끔하게 변환되지 않을 수 있습니다.
3. 출처 간 문제 : 일부 웹사이트는 알 수 없는 출처의 요청을 차단할 수 있습니다.

디버그 모드

추가 디버깅 정보를 보려면 DEBUG 환경 변수를 설정하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• 모델 컨텍스트 프로토콜 로 구축됨
• 보안에 중점을 둔 현대적이고 적극적으로 유지 관리되는 라이브러리를 사용합니다.
• OWASP 권장 사항을 기반으로 한 살균 접근 방식

최종 업데이트: 2025년 3월 29일