EasyAccessPDF

EasyAccessPDF — MCP 服务示例

English | Deutsch | Français | Español | 日本語

🌐 官方网站：easyaccesspdf.com · 免费 PDF 检查器 · 定价 · MCP 设置指南

将 AI 客户端（Claude Code、Claude Desktop、Cursor、Codex）连接到 EasyAccessPDF MCP 服务：将文档转换为 Markdown，将 PDF 导出为 JSON/HTML/文本，运行 veraPDF 无障碍检查，并自动修复 PDF/UA 问题——直接在你的 AI 工作流中完成。

• Endpoint： https://easyaccesspdf.com/wp-json/easy/v1/mcp
• Protocol： 通过 Streamable HTTP 传输的 MCP（JSON-RPC 2.0，协议版本 2025-03-26）
• Auth： HTTP Basic——你的 EasyAccessPDF 帐户邮箱 + WordPress 应用程序密码
• Introspection： initialize、ping 和 tools/list 无需身份验证即可响应——只有 tools/call 需要凭据
• Site： https://easyaccesspdf.com/mcp/

工具（5）

工具	功能	费用
eap_convert_to_markdown	文档（PDF、DOCX、DOC、PPT、XLS、HTML、EPUB、RTF、ODT、TXT）→ 清晰的 Markdown	会员权益包含
eap_export_pdf	PDF → json（结构化树）、html、text 或 annotated-pdf（布局可视化，24 小时下载 URL）	会员权益包含
eap_check_pdf	veraPDF PDF/UA-1（ISO 14289-1）无障碍审计：页面、等级 A/B/C/F、问题列表、标签覆盖率	会员权益包含
eap_get_account_status	套餐、到期时间、积分余额、当前价格	会员权益包含
eap_fix_pdf	自动添加标签 + 注入元数据 + veraPDF 重新审计 → zip 文件的 24 小时下载 URL（已添加标签的 PDF + 报告 + 手动审核清单）	每份文档 1 积分——会员和非会员均需付费

所有工具都需要提供文档的公开可访问 URL（最大 50MB）。文档在欧盟（法兰克福）处理，不会存储。

输入架构（实时来自 tools/list）

// eap_convert_to_markdown
{ "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] }

// eap_export_pdf
{ "type": "object",
  "properties": {
    "url": { "type": "string" },
    "format": { "type": "string", "enum": ["json", "html", "text", "annotated-pdf"] } },
  "required": ["url", "format"] }

// eap_check_pdf
{ "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"] }

// eap_fix_pdf
{ "type": "object",
  "properties": { "url": { "type": "string" }, "title": { "type": "string" } },
  "required": ["url"] }

// eap_get_account_status
{ "type": "object", "properties": [] }

1. 获取凭据

1. 在 https://easyaccesspdf.com/my-account/ 创建帐户并验证邮箱（6 位验证码）。
2. 购买 MCP Membership（$19.90 / 32 天，不自动续订——购买期限可叠加），或购买 eap_fix_pdf 积分包。
3. 在 My Account → Profile → Application Passwords 中创建新的应用程序密码（例如命名为 claude）。
4. 构建 Basic 令牌：base64( [email protected] : your-application-password )。

# Linux / macOS
printf '[email protected]:xxxx xxxx xxxx xxxx xxxx xxxx' | base64
# Windows PowerShell
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('[email protected]:xxxx xxxx xxxx xxxx xxxx xxxx'))

请妥善保管令牌——它可以消耗你的积分。你可以随时在 WP 个人资料中撤销令牌。

2. 客户端设置

Claude Code

claude mcp add --transport http easyaccesspdf \
  https://easyaccesspdf.com/wp-json/easy/v1/mcp \
  --header "Authorization: Basic <BASE64>"
claude mcp list   # should show easyaccesspdf with 5 tools

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json（Windows）/ ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "easyaccesspdf": {
      "type": "http",
      "url": "https://easyaccesspdf.com/wp-json/easy/v1/mcp",
      "headers": { "Authorization": "Basic <BASE64>" }
    }
  }
}

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "easyaccesspdf": {
      "type": "streamable-http",
      "url": "https://easyaccesspdf.com/wp-json/easy/v1/mcp",
      "headers": { "Authorization": "Basic <BASE64>" }
    }
  }
}

Codex（OpenAI）

~/.codex/config.toml：

[mcp_servers.easyaccesspdf]
url = "https://easyaccesspdf.com/wp-json/easy/v1/mcp"
http_headers = { "Authorization" = "Basic <BASE64>" }

使用 codex mcp list 验证。

仅支持 stdio 的客户端（桥接程序）

仅支持 stdio MCP 的客户端可以使用 bridge/eap-mcp-bridge.mjs——这是一个零依赖的 Node 18+ 脚本，可将 stdio JSON-RPC 转发到托管端点。另附 Dockerfile，供容器化运行器使用。

{
  "mcpServers": {
    "easyaccesspdf": {
      "command": "node",
      "args": ["bridge/eap-mcp-bridge.mjs"],
      "env": { "EAP_TOKEN": "<BASE64>" }
    }
  }
}

也可以使用 Docker：docker build -t eap-mcp-bridge . && docker run -i --rm -e EAP_TOKEN=<BASE64> eap-mcp-bridge。如果没有 EAP_TOKEN，桥接程序仍会响应 initialize / tools/list（可公开进行内省）；随后调用 tools/call 会返回上游 401。

3. 最简客户端（无需 SDK）

参见 examples/python_client.py 和 examples/node_client.mjs——使用纯 HTTP/JSON-RPC，除 requests / Node 18+ 外无其他依赖。

python examples/python_client.py
node examples/node_client.mjs

两者都会依次运行：initialize → tools/list → eap_get_account_status，并打印结果。

账单透明度

• 会员资格（$19.90 / 32 天，可叠加，无自动续费）包含不限次数的转换、导出、检查和账户状态查询。
• eap_fix_pdf 始终按每份文档收费 1 个修复额度（单次修复价值 $2.99；购买额度包后每次低至 $0.67）——会员和非会员均适用。会员资格不包含修复特权。
• 额度永不过期。定价：https://easyaccesspdf.com/pricing/

许可证

MIT — 参见 LICENSE。这些仅为示例；EasyAccessPDF 是由德国 HEPA Zweigniederlassung der RUBIX GmbH 运营的商业服务。