npm pdfops-mcpstdioMITupdated 12d ago
MCP server that gives AI agents deterministic PDF tools, backed by the PDFops API: inspect AcroForm fields, fill forms, merge PDFs, and generate invoices — no Chromium, no native deps, nothing to host.
pdfops mcp で何ができる?
pdfops-mcp
MCP server that gives AI agents deterministic PDF tools, backed by the PDFops API: inspect AcroForm fields, fill forms, merge PDFs, and generate invoices — no Chromium, no native deps, nothing to host.
Tools operate on local file paths, so PDF bytes never transit the model context: your agent says "fill /tmp/form.pdf and save to /tmp/out.pdf" and gets a one-line confirmation back.
Install
Claude Code
claude mcp add pdfops -- npx -y pdfops-mcp
Claude Desktop (claude_desktop_config.json) / Cursor (.cursor/mcp.json)
{
"mcpServers": {
"pdfops": {
"command": "npx",
"args": ["-y", "pdfops-mcp"],
"env": { "PDFOPS_API_KEY": "pdfops_live_…" }
}
}
}
PDFOPS_API_KEY is optional — without it you get the keyless trial (100 requests/IP/month). A free key (250/month, no card) takes one field at pdfops.dev/pricing.
Tools
| Tool | What it does |
|---|---|
pdf_inspect |
List a PDF's form fields (names, types, options, values) + a paste-ready fill template. Call first on unfamiliar PDFs. |
pdf_fill |
Fill AcroForm fields → write the filled PDF. Optional flatten bakes values in and drops the form. |
pdf_merge |
Merge ≥2 PDFs in order → write the result. |
pdf_invoice |
Structured data → complete invoice PDF. Deterministic: same input, byte-identical output. |
pdfops_usage |
Quota check for the configured key. |
Example agent flow
"Fill the W-9 template at ~/docs/w9.pdf for Ada Lovelace and merge it with ~/docs/cover.pdf"
pdf_inspect→ discovers field names + fill templatepdf_fill→ writes the filled W-9pdf_merge→ writes the combined packet
Links
API docs: pdfops.dev/docs · OpenAPI: pdfops.dev/openapi.json · Typed client: pdfops-sdk · Questions: hello@pdfops.dev
MIT © PDFops
インストール
pdfops mcp をクライアントに追加します。お使いのものを選んでください。
claude mcp add pdfops-mcp -- npx -y pdfops-mcpcodex mcp add pdfops-mcp -- npx -y pdfops-mcpamp mcp add pdfops-mcp -- npx -y pdfops-mcp{
"mcpServers": {
"pdfops-mcp": {
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"pdfops-mcp": {
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"pdfops-mcp","command":"npx","args":["-y","pdfops-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"pdfops-mcp": {
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"pdfops-mcp": {
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"pdfops-mcp": {
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"pdfops-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"pdfops-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"pdfops-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"pdfops-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y pdfops-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
5 個のツール
pdfops mcp は接続したエージェントに 5 個のツールを提供します。
- pdf_inspect
- List a PDF's form fields (names, types, options, values) + a paste-ready fill template. Call first on unfamiliar PDFs.
- pdf_fill
- Fill AcroForm fields → write the filled PDF. Optional `flatten` bakes values in and drops the form.
- pdf_merge
- Merge ≥2 PDFs in order → write the result.
- pdf_invoice
- Structured data → complete invoice PDF. Deterministic: same input, byte-identical output.
- pdfops_usage
- Quota check for the configured key.
スコア
81 / 100
優秀
- ドキュメント22/25
- メンテナンス25/25
- 信頼性16/20
- 機能6/15
- 導入のしやすさ12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 4 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 5 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
バージョン履歴
| バージョン | 公開日 |
|---|---|
| 0.2.1最新 | 2026年8月27日 |
| 0.2.0 | 2026年8月6日 |
| 0.1.1 | 2026年7月22日 |