GroupDocs.Markdown MCP server
2026년 9월 4일 커밋AI agent을 사용하여 PDF, DOCX, XLSX 등 다양한 문서 형식을 정돈된 구조의 Markdown으로 변환합니다.
다른 이름 groupdocs-markdown/GroupDocs.Markdown.Mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 26.9.0
- 마지막 커밋
- 2026년 9월 4일
- 라이선스
- MIT
GroupDocs.Markdown MCP란?
AI agent을 사용하여 PDF, DOCX, XLSX 등 다양한 문서 형식을 정돈된 구조의 Markdown으로 변환합니다.
프로젝트 README에서 생성된 요약
GroupDocs.Markdown MCP server 정보
이 server는 PDF, DOCX, XLSX와 같은 복잡한 문서 형식을 구조화된 Markdown으로 변환하여 AI agent가 처리할 수 있도록 합니다. Claude, Cursor 또는 GitHub Copilot을 사용하는 개발자는 이 도구를 사용하여 다양한 파일 형식을 깔끔한 Markdown 텍스트로 변환할 수 있으며, 기본적으로 이미지를 base64로 임베딩할 수도 있습니다. 이 server는 파일 변환을 위한 ConvertToMarkdown 및 전체 변환 없이 페이지 수, 작성자, 암호화 상태와 같은 메타데이터를 가져오는 GetDocumentInfo와 같은 특정 도구를 제공합니다.
사용자는 dnx, 글로벌 dotnet tool 또는 Docker를 사용하여 server를 로컬에서 실행할 수 있습니다. .NET 10 SDK가 필요하며 환경 변수를 통해 특정 저장소 및 출력 경로를 설정할 수 있습니다. server 자체는 MIT 라이선스이지만, 기반 엔진은 기본적으로 평가 모드로 작동하여 프로세스당 문서 수를 15개로 제한합니다. 이러한 제한을 제거하려면 GROUPDOCS_LICENSE_PATH를 통해 라이선스 파일을 제공하거나 공개 키 및 개인 키를 사용하는 종량제 방식을 사용할 수 있습니다.
활용 사례
- 1문서를 Markdown으로 변환AI가 더 쉽게 처리할 수 있도록 PDF 또는 Word 문서를 구조화된 Markdown 파일로 변환합니다.
- 2문서 메타데이터 추출문서 전체를 변환하지 않고 작성자 또는 페이지 수와 같은 파일의 특정 세부 정보를 가져옵니다.
- 3텍스트에 이미지 임베딩모든 시각적 요소가 base64 문자열로 포함되도록 보장하면서 사업 계획서를 Markdown으로 내보냅니다.
- 4라이선스 상태 확인server가 종량제 모드로 실행 중인지 확인하고 남은 크레딧을 체크합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
GROUPDOCS_LICENSE_PATHGROUPDOCS_MCP_OUTPUT_PATHGROUPDOCS_MCP_STORAGE_PATHGROUPDOCS_METERED_PRIVATE_KEYGROUPDOCS_METERED_PUBLIC_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| GROUPDOCS_LICENSE_PATH | — | |
| GROUPDOCS_MCP_OUTPUT_PATH | — | |
| GROUPDOCS_MCP_STORAGE_PATH | — | |
| GROUPDOCS_METERED_PRIVATE_KEY | — | |
| GROUPDOCS_METERED_PUBLIC_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능groupdocs-markdown/groupdocs.markdown.mcp is public and reachablegithub.com/groupdocs-markdown/groupdocs.markdown.mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-04github.com/groupdocs-markdown/groupdocs.markdown.mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기GroupDocs.Markdown MCP Server
MCP server that exposes GroupDocs.Markdown as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents — convert documents to clean, structured Markdown.
Installation
One-click installs pre-fill every supported setting: edit the placeholder documents folder after install (output defaults to the same folder); an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode - point it at your license to lift limits.
More clients - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022, Cursor, Windsurf, Cline, and JetBrains Rider live in
install/generated/.
Requires .NET 10 SDK.
Run directly with dnx (recommended — no install step):
dnx GroupDocs.Markdown.Mcp --yes
Pulls the latest stable release on every invocation. To pin to a specific
version (recommended for shared configs and CI), append @<version>:
dnx GroupDocs.Markdown.Mcp@26.9.0 --yes
Or install as a global dotnet tool:
dotnet tool install -g GroupDocs.Markdown.Mcp
groupdocs-markdown-mcp
Or run via Docker:
docker run --rm -i \
-v $(pwd)/documents:/data \
ghcr.io/groupdocs-markdown/markdown-net-mcp:latest
No native prerequisites are required on any platform — the underlying
GroupDocs.Markdown engine renders image-bearing documents through a
self-contained SkiaSharp native asset, so dnx, the global tool, and the
Docker image all run with no extra apt/brew setup.
Available MCP Tools
| Tool | Description |
|---|---|
ConvertToMarkdown |
Converts a document (PDF, DOCX, XLSX, EPUB, MOBI, …) to clean, structured Markdown and saves the .md to storage. Images embed as base64 by default. |
GetDocumentInfo |
Returns file format, page count, title, author, and encryption flag as JSON, without converting. |
Reverse Markdown → document composition is not yet implemented in the underlying GroupDocs.Markdown 26.3.0 engine (
MarkdownConverter.FromMarkdownStringthrowsNotImplementedException), so this server does not expose aComposeFromMarkdowntool. Use the GroupDocs.Conversion MCP with a.mdsource file if you need Markdown → DOCX / PDF / HTML output today.
Example prompts for AI agents
- "Convert report.pdf to Markdown"
- "Export business-plan.docx as Markdown with images embedded as base64"
- "Convert pages 1-3 of contract.pdf to Markdown, text only — skip images"
- "How many pages does business-plan.pdf have?"
- "What format and author does cost-analysis.xlsx have?"
Licensing
The MCP server itself is MIT; the underlying GroupDocs.Markdown engine requires a license for production use. Without one the server runs in evaluation mode:
- Output may be limited and carries an evaluation notice.
- A single server process can open at most 15 documents; further calls fail with an evaluation-cap error until the server restarts.
There are two ways to license the server.
License file — point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic. Works offline.
Metered (pay-per-use) — set both GROUPDOCS_METERED_PUBLIC_KEY and
GROUPDOCS_METERED_PRIVATE_KEY. You are billed for what you actually process, which suits AI
agents well because their usage is bursty and hard to predict up front. If both a metered key pair
and a license file are configured, metered wins and the file is ignored.
Metered mode needs outbound connectivity. Usage is reported to GroupDocs servers, so air-gapped or firewalled deployments must allow that egress — or use a license file instead.
Call the get_license_status tool at any time to see which mode is active, and — under
metered — the consumed quantity and remaining credit.
Keeping the private key out of your config
The metered private key is a secret. MCP client configs are plain files on disk, and a
project-scoped .mcp.json is committed by convention, so prefer, in order:
- Set the variables in your OS environment and leave them out of the config entirely. An
stdio MCP server inherits its client's environment, so this works in every client.
On macOS note that an app launched from Finder does not inherit shell exports — use
launchctl setenv, or launch the client from a terminal. - Reference them indirectly if your client supports it (Claude Code expands
${VAR}; VS Code uses${env:VAR}and${input:...}). - A literal value in a user-scoped config (for example
~/.claude.json) is acceptable for a single developer. - Never commit a literal key in a project-scoped
.mcp.json.
For Docker, forward the values without writing them into any file:
docker run --rm -i \
-e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \
-v /path/to/documents:/data \
ghcr.io/groupdocs-markdown/markdown-net-mcp:latest
To lift the limits with a license file:
Configuration
| Variable | Description | Default |
|---|---|---|
GROUPDOCS_MCP_STORAGE_PATH |
Base folder for input and output files | current directory |
GROUPDOCS_MCP_OUTPUT_PATH |
(Optional) separate folder for output files | GROUPDOCS_MCP_STORAGE_PATH |
GROUPDOCS_LICENSE_PATH |
Path to GroupDocs license file | (evaluation mode) |
GROUPDOCS_METERED_PUBLIC_KEY |
Metered public key. Requires the private key too; takes precedence over the license file | (unset) |
GROUPDOCS_METERED_PRIVATE_KEY |
Metered private key. Secret - see Licensing | (unset) |
In evaluation mode (no license) the converted Markdown may be limited and can
include an evaluation notice. Supply GROUPDOCS_LICENSE_PATH for unrestricted
output.
Usage with Claude Desktop
{
"mcpServers": {
"groupdocs-markdown": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Markdown.Mcp", "--yes"],
"env": {
"GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
}
}
}
}
To pin to a specific version, replace
"GroupDocs.Markdown.Mcp"with"GroupDocs.Markdown.Mcp@26.9.0"inargs. Pinning is recommended for shared / committed configs to avoid surprise upgrades.
Usage with VS Code / GitHub Copilot
NuGet.org generates a ready-to-use mcp.json snippet on the package page.
Copy it directly into your .vscode/mcp.json.
Alternatively, add manually to .vscode/mcp.json:
{
"inputs": [
{
"type": "promptString",
"id": "storage_path",
"description": "Base folder for input and output files.",
"password": false
}
],
"servers": {
"groupdocs-markdown": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Markdown.Mcp", "--yes"],
"env": {
"GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
}
}
}
}
Same pinning rule as above — swap
"GroupDocs.Markdown.Mcp"for"GroupDocs.Markdown.Mcp@26.9.0"to lock to a specific release.
Usage with Docker Compose
cd docker
docker compose up
Edit docker/docker-compose.yml to point volumes at your local documents folder.
Documentation & guides
Step-by-step deployment guides and a published-package integration test suite live in the companion repo GroupDocs.Markdown.Mcp.Tests:
- Install from NuGet —
dnx, global tool, pinned vs always-latest - Run via Docker
- Verify on the MCP registry
- Use with Claude Desktop
- Use with VS Code / GitHub Copilot
- Run the integration tests
That repo also exercises every advertised tool against the published NuGet artifact on Linux, macOS, and Windows in CI — so the snippets above are verified end-to-end on every release.
License
MIT — see LICENSE
GroupDocs.Markdown MCP 질문
어떤 파일 형식을 Markdown으로 변환할 수 있나요?
이 MCP server는 PDF, DOCX, XLSX, EPUB, MOBI 등을 Markdown으로 변환하는 기능을 지원합니다.
Markdown을 다시 다른 문서 형식으로 변환할 수 있나요?
아니요, Markdown을 다른 문서 유형으로 역변환하는 기능은 아직 이 server에 구현되지 않았습니다.
운영 환경에서 사용하려면 라이선스가 필요한가요?
네, MCP server 자체는 MIT 라이선스이지만, 기반이 되는 GroupDocs.Markdown 엔진은 운영 환경에서 사용하려면 라이선스가 필요합니다. 라이선스가 없으면 평가 모드로 동작합니다.
평가 모드의 제한 사항은 무엇인가요?
평가 모드에서는 출력이 제한될 수 있고 평가 안내 문구가 포함될 수 있으며, 단일 server 프로세스당 최대 15개의 문서만 열 수 있습니다.