com.pennyocr/ocr
Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http ocr 'https://mcp.pennyocr.com' --header 'Authorization: <Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>'
{
"mcpServers": {
"ocr": {
"type": "http",
"url": "https://mcp.pennyocr.com",
"headers": {
"Authorization": "<Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
🪙 PennyOCR MCP server
A remote Model Context Protocol server that gives any agent document-reading eyes: PDFs and images by URL → markdown (tables preserved) or plain text, with exact cost reporting and hard spend caps.
Hosted at https://mcp.pennyocr.com — nothing to install:
{
"mcpServers": {
"pennyocr": {
"url": "https://mcp.pennyocr.com",
"headers": { "Authorization": "Bearer pk_live_..." }
}
}
}
Keys are free (first 100 pages free) at pennyocr.com/dashboard.
Clients that can't set headers: https://mcp.pennyocr.com/?key=pk_live_...
Tools
| Tool | Input | Output |
|---|---|---|
read_document | {url, pages?, output?, max_pages?, max_cost_usd?} | {content, pages, cost_usd, citations[]} |
estimate_cost | {url, pages?} | page count + exact cost — free |
check_balance | {} | remaining credits + free-tier allowance — free |
The cost caps refuse before any processing, with the numbers — so autonomous agents can reason about spend ("200 pages, $0.15 — proceed") and can never run past a prepaid balance.
Transport
Streamable HTTP (JSON-RPC 2.0 over POST), stateless. This repo is the complete server —
a single Cloudflare Worker (worker.js) proxying the PennyOCR API.
Pricing: $0.75 per 1,000 pages · pennyocr.com/pricing.txt · Agent onboarding: pennyocr.com/llms.txt
الأسئلة الشائعة
ما هو com.pennyocr/ocr؟
Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.
كيف أثبّت com.pennyocr/ocr؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http ocr 'https://mcp.pennyocr.com' --header 'Authorization: <Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج com.pennyocr/ocr إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل com.pennyocr/ocr مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون com.pennyocr/ocr؟
ينشره imiraoui. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.