@sheetrender/mcp

SheetRender용 MCP 서버입니다 — AI 어시스턴트가 HTML 템플릿과 스프레드시트 데이터로 PDF를 렌더링할 수 있게 해 줍니다.

설정

sheetrender.com → 설정 → API 키에서 API 키를 받은 다음 MCP 클라이언트 설정에 추가하세요:

{
  "mcpServers": {
    "sheetrender": {
      "command": "npx",
      "args": ["-y", "@sheetrender/mcp"],
      "env": { "SHEETRENDER_API_KEY": "sr_live_..." }
    }
  }
}

SHEETRENDER_API_URL도 읽으며, 기본값은 https://sheetrender.com입니다. 자체 호스팅 또는 스테이징 인스턴스를 가리킬 때만 설정하세요.

Related MCP server: Dokmatiq DocGen

도구

render_pdf

제공한 HTML에서 PDF 하나를 렌더링합니다.

저장된 PDF의 경로와 크기를 반환합니다. 512 KB 미만이면 base64 리소스로 인라인 첨부되므로, 첨부 파일을 표시하는 클라이언트에서는 문서 자체가 보입니다.

서버 제한 두 가지가 적용됩니다. 2 MB를 초과하는 HTML은 거부됩니다. 전송한 내용과 data가 치환된 후의 문서 모두를 기준으로 측정하므로, 작성한 마크업이 한도를 넘지 않아도 긴 데이터셋을 확장하는 템플릿은 한도를 넘을 수 있습니다. 또한 무료 플랜에서는 render_pdf와 render_template 모두 렌더링된 모든 PDF에 "Made with SheetRender" 바닥글이 포함되지만, 유료 플랜에는 포함되지 않습니다.

list_templates

인자가 없습니다. 저장된 각 템플릿의 이름, ID, 마지막 업데이트 날짜를 반환합니다. 사용자가 언급한 템플릿 이름을 다른 도구들이 필요로 하는 ID로 바꾸려면 이 도구를 호출하세요.

render_template

계정에 이미 저장된 템플릿에서 PDF 하나를 렌더링합니다.

render_pdf와 동일한 반환 형식입니다.

create_batch_job

프로젝트에 이미 업로드된 데이터셋의 행마다 PDF 하나씩 렌더링하는 백그라운드 작업을 대기열에 추가합니다. 이 서버는 스프레드시트를 업로드할 수 없습니다.

get_job으로 폴링할 작업 ID를 반환합니다. filename_template과 group_by는 각각 템플릿과 프로젝트에 유지되므로 이후 실행의 기본값도 바꾼다는 점에 유의하세요.

서버가 공개 배치 엔드포인트보다 이전 버전이면, 도구는 불명확한 오류로 실패하는 대신 배치 작업을 사용할 수 없다고 보고합니다.

get_job

job_id를 받습니다. 상태, 완료 및 실패한 행 수를 반환하고, 작업이 succeeded, partial, failed 또는 cancelled 상태에 도달하면 렌더링된 모든 문서의 ID와 파일 이름을 반환합니다. 작업이 queued, retry_queued 또는 running인 동안에는 문서 목록이 비어 있습니다. get_document가 받는 것이 바로 이 문서 ID들입니다.

get_document

document_id를 받아 해당 단일 렌더링 PDF를 다운로드합니다. ID는 완료된 배치의 get_job에서 얻습니다. 다른 방법으로는 얻을 수 없습니다. render_pdf와 동일한 반환 형식, 즉 경로, 크기, 그리고 512 KB 미만의 인라인 blob을 반환합니다.

전체 배치의 경우 웹 앱의 병합된 PDF와 ZIP이 문서를 하나씩 가져오는 것보다 낫습니다.

page_settings

두 렌더링 도구가 공유하며, 모든 필드는 선택입니다:

{
  "page_size": "a4",
  "orientation": "portrait",
  "margins": { "top": 15, "right": 15, "bottom": 15, "left": 15 }
}

page_size는 소문자입니다 — a3, a4, a5, letter, legal 또는 tabloid. 여백은 CSS 길이가 아닌 밀리미터 단위의 일반 숫자입니다.

렌더링된 PDF는 시스템 임시 디렉터리에 기록됩니다. API 오류(잘못된 키, 없는 템플릿, 요청 한도 초과)는 서버 자체 메시지를 담은 도구 오류로 반환됩니다.

공개 API는 API 키당 분당 120개의 요청을 허용합니다. 이를 초과하면 429를 반환하고 도구는 요청 한도에 걸렸으니 잠시 후 다시 시도하라고 보고합니다. 배치 작업 생성은 별도로 더 엄격하게 측정됩니다.

개발

호스트의 node/npm이 필요 없습니다 — scripts/dev.sh install, scripts/dev.sh deno task build.

MIT 라이선스입니다.