A
licenseNot graded
qualityB
maintenanceEnables AI agents and users to process documents through natural language, supporting PDF operations like text extraction, redaction, splitting, form filling, annotations, and content search.
45 npm
62
MIT
pdf-agent-toolkit-mcp
PDF Agent Toolkit & MCP Server (ihatepdf.cv에서 영감을 받음)
AI 에이전트(Claude Desktop, Cursor, Windsurf, LangChain, Claude Code)를 위한 포괄적이고 프라이버시 우선의 PDF 조작 제품군이자 Model Context Protocol (MCP) 서버입니다.
핵심 철학
클라우드 업로드 제로: 모든 PDF 처리(압축, 페이지 재정렬, 회전, 편집(redaction), 텍스트 추출)는 순수 TypeScript & WebAssembly로 100% 로컬에서 실행됩니다.
에이전트 토큰 최적화: 프롬프트에 원시 PDF base64 덤프를 넣지 않아 컨텍스트 비대화를 제거하며, 요청 시 구조화된 개요와 페이지 스니펫을 반환합니다.
범용 호환성:
stdioJSON-RPC 2.0과 즉시(별도 설정 없이) 작동합니다.
Related MCP server: pdfeverything
🛠️ 사용 가능한 MCP 도구
도구 이름 | 카테고리 | 설명 | 에이전트 최적화 |
| 최적화 | 스트림 조각 모음과 DPI 사전 설정( | 후속 OCR/비전 토큰 비용을 최대 70% 절감합니다. |
| 인텔리전스 | 문서 목차(TOC), 개요, 단어 수, 깔끔한 Markdown 텍스트를 추출합니다. | 원시 스트림 덤프 대비 약 90%의 컨텍스트 토큰을 절약합니다. |
| 보안 | SSN(사회보장번호), 이메일, 신용카드, Aadhaar 번호, 사용자 지정 키워드를 감지하여 검은색 편집(redaction) 박스를 찍습니다. | 문서를 외부 LLM에 보내기 전에 GDPR/HIPAA 규정 준수를 보장합니다. |
| 구조 | 복합 도구: 페이지 재정렬, 삭제, 회전(90/180/270°), 페이지 번호 추가를 한 번의 원자적 작업으로 수행합니다. | 다중 턴 왕복(roundtrip)을 방지합니다. |
| 구조 | 특정 페이지 범위(예: | 에이전트가 특정 챕터를 검사할 수 있게 합니다. |
| 구조 | 여러 입력 PDF를 단일 문서로 결합합니다. | 빠른 다중 파일 문서 컴파일. |
| 보안 | 사용자 지정 회전 및 불투명도로 시각적 텍스트 워터마크(예: | 시각적 상태 스탬핑. |
| 생성 | 깔끔한 Markdown/텍스트를 스타일화된 헤더 배너가 있는 A4 PDF로 포맷합니다. | 헤드리스 브라우저 부담 없이 가벼운 문서 생성. |
| 양식 | AcroForm 필드를 검사하고 양식 데이터를 채웁니다. | 인보이스, 세금, 계약 처리를 자동화합니다. |
🚀 에이전트용 빠른 시작 구성
1. Cursor IDE (.cursor/mcp.json)
{
"mcpServers": {
"pdf-agent-toolkit": {
"command": "npx",
"args": ["-y", "pdf-agent-toolkit-mcp@latest"]
}
}
}2. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"pdf-tools": {
"command": "npx",
"args": ["-y", "pdf-agent-toolkit-mcp"]
}
}
}3. LangChain & LangGraph (Python)
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_google_genai import ChatGoogleGenerativeAI
async def main():
async with MultiServerMCPClient({
"pdf_tools": {
"command": "npx",
"args": ["-y", "pdf-agent-toolkit-mcp"],
"transport": "stdio",
}
}) as client:
tools = client.get_tools()
model = ChatGoogleGenerativeAI(model="gemini-2.5-flash")
agent = create_react_agent(model, tools)
response = await agent.ainvoke({
"messages": [("user", "Compress ./financials.pdf and blackout sensitive SSNs")]
})
print(response)💻 서버를 로컬에서 실행하기
# Run MCP server on stdio
npm run mcp
# Start the interactive visual testing studio and playground
npm run devThis server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Merge, split, extract, rotate, reorder and stamp PDF pages from your AI chat, all offline.
Merge, split, extract, rotate, reorder and stamp PDF pages from your AI chat, all offline.
Merge, split, extract, rotate, reorder and stamp PDF pages from your AI chat, all offline.
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to perform 13 PDF operations (merge, split, compress, watermark, encrypt, and more) on local files via MCP.3-
- AlicenseCqualityCmaintenanceEnables AI assistants to perform PDF operations like merge, split, compress, convert, encrypt, OCR, and summarize using natural language.9813 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to inspect PDFs, merge or extract pages, and clean text entirely offline through the Model Context Protocol, with no uploads, API keys, or network calls.436 npmMIT