Markovo CLI 및 MCP 서버

Markovo는 지원되는 파일과 명시적으로 허가된 공개 HTTPS 페이지를 깔끔한 Markdown으로 변환합니다. 전용 웹 경험 및 제품 세부 정보는 PDF to Markdown 변환기를 방문하세요.

이 공개 저장소는 고객 측 markovo CLI 및 markovo-mcp stdio MCP 서버의 배포 소스입니다. 로컬 변환 엔진, 백엔드 서비스, 배포 구성, 프로덕션 자격 증명 또는 결제 구현을 포함하지 않습니다. 변환은 https://markovo.net의 계정 기반 서비스를 통해 실행됩니다.

설치

pip install markovo

또는 영구 설치 없이 실행:

uvx markovo --help
uvx --from markovo markovo-mcp

Related MCP server: MarkItDown MCP Server

API 키 및 크레딧

1. 개발자 포털에서 API 키를 생성합니다.

2. 셸 또는 MCP 호스트 비밀 저장소에 저장하고, 프롬프트에 붙여넣거나 소스 제어에 커밋하지 마세요.

3. 설정을 확인합니다:

export MARKOVO_API_KEY="your-key"
markovo doctor --json

모든 변환에는 명시적인 크레딧 한도가 필요합니다. 키가 없으면 클라이언트는 개발자 포털을 안내합니다. 크레딧이 부족하면 서비스 응답이 결제 페이지를 안내하여 계정을 충전한 후 다시 시도할 수 있습니다.

MCP 구성

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "markovo-mcp"],
      "env": {
        "MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
        "MARKOVO_MCP_ROOT": "/path/to/safe/project"
      }
    }
  }
}

MCP 클라이언트는 비밀 저장소 또는 환경 변수 설정을 통해 MARKOVO_API_KEY를 주입해야 합니다. 키와 서비스 출처는 MCP 도구 인수에 포함되지 않으므로, 프롬프트가 자격 증명을 리디렉션할 수 없습니다. 공개 클라이언트는 https://markovo.net만 허용하며 인증된 리디렉션을 따르지 않습니다.

MCP 서버는 필수 MARKOVO_MCP_ROOT 내에서만 읽고 쓸 수 있습니다. MCP 호스트가 필요로 하는 가장 작은 전용 프로젝트 디렉터리로 설정하세요. 이 값이 없으면 서버는 모든 파일 도구를 거부합니다. 상위 디렉터리 및 심볼릭 링크 이스케이프는 거부됩니다.

export MARKOVO_MCP_ROOT="/path/to/safe/project"

구조화된 오류는 키가 없을 때 개발자 포털을, 크레딧이 부족할 때 결제를 안내합니다.

링크

• Markovo 홈

• PDF to Markdown

• 문서

• 요금 및 크레딧

• 개발자 포털 및 API 키

• 결제 및 충전

보안

SECURITY.md의 지침에 따라 보안 문제를 비공개로 신고하세요. API 키, 고객 문서 또는 개인 변환 결과를 공개 이슈에 포함하지 마세요.