---
title: "ChatFiles vs pdf-reader-mcp"
type: "comparison"
canonical_url: "https://www.graphcanon.com/compare/guangzhengli-chatfiles-vs-sylphxai-pdf-reader-mcp"
tools: ["guangzhengli-chatfiles", "sylphxai-pdf-reader-mcp"]
---

# ChatFiles vs pdf-reader-mcp

*GraphCanon updated Sep 20, 2026*

## Verdict

Pick ChatFiles if chatFiles uses GPT and embedding technologies with LangchainJS for document interaction via a Supabase vector database; pick pdf-reader-mcp if pdf-reader-mcp acts as an intelligence layer for PDFs to support AI agents in document handling, offering features like evidence-first extraction and OCR with a focus on accuracy and provenance via the MCP server.

[ChatFiles](https://github.com/guangzhengli/ChatFiles) reports 3.3k GitHub stars, 461 forks, and 18 open issues, last pushed Dec 17, 2024. [pdf-reader-mcp](https://sylphxai.github.io/pdf-reader-mcp/) has 935 stars, 82 forks, and 1 open issues, last pushed Sep 20, 2026. Figures are from public GitHub metadata via [ChatFiles's repository](https://github.com/guangzhengli/ChatFiles) and [pdf-reader-mcp's repository](https://github.com/SylphxAI/pdf-reader-mcp).

| | [ChatFiles](/tools/guangzhengli-chatfiles.md) | [pdf-reader-mcp](/tools/sylphxai-pdf-reader-mcp.md) |
| --- | --- | --- |
| Tagline | Document Chatbot powered by GPT and Embedding | PDF intelligence layer for AI agents providing features such as evidence-first extraction and OCR |
| Stars | 3,337 | 935 |
| Forks | 461 | 82 |
| Open issues | 18 | 1 |
| Language | TypeScript | TypeScript |
| Adopt for | ChatFiles uses GPT and embedding technologies with LangchainJS for document interaction via a Supabase vector database. | pdf-reader-mcp acts as an intelligence layer for PDFs to support AI agents in document handling, offering features like evidence-first extraction and OCR with a focus on accuracy and provenance via the MCP server. |
| Persona | - | - |
| Runtime | - | - |
| License | MIT | MIT |
| Categories | AI Agents, Vector Databases | AI Agents, Data & Retrieval |

## Trust and health

_Sourced signals - not a safety guarantee. No winner column._

| | [ChatFiles](/tools/guangzhengli-chatfiles.md) | [pdf-reader-mcp](/tools/sylphxai-pdf-reader-mcp.md) |
| --- | --- | --- |
| Maintenance | Dormant (18%) | Very active (96%) |
| Days since push | 641d | 0d |
| Open issues (now) | 18 | 1 |
| Stars delta | -4 (30d) | +96 (30d) |
| Owner type | User | Organization |
| Full report | [trust report](/tools/guangzhengli-chatfiles/trust.md) | [trust report](/tools/sylphxai-pdf-reader-mcp/trust.md) |

## Decision facts: ChatFiles

- **Pricing:** freemium - Available under the MIT license, it is free to use. However, users might incur costs for hosting with Vercel and database usage on Supabase.
- **Requirements:** Local setup requires setting environment variables as outlined in the documentation.
- **Adopt for:** ChatFiles uses GPT and embedding technologies with LangchainJS for document interaction via a Supabase vector database.

## Decision facts: pdf-reader-mcp

- **Adopt for:** pdf-reader-mcp acts as an intelligence layer for PDFs to support AI agents in document handling, offering features like evidence-first extraction and OCR with a focus on accuracy and provenance via the MCP server.

## Choose when

### Choose ChatFiles if…

- Pricing: Available under the MIT license, it is free to use. However, users might incur costs for hosting with Vercel and database usage on Supabase..
- Requirements: Local setup requires setting environment variables as outlined in the documentation..
- Tags unique to ChatFiles: chatbot, embedding, gpt-api, supabase.
- Also covers Vector Databases.
- ChatFiles ships Docker support for self-hosted deployment.
- You need to integrate file-based conversations into your web apps using TypeScript.

### Choose pdf-reader-mcp if…

- Tags unique to pdf-reader-mcp: agent-document-twin, ai-tools, document-intelligence, document-processing.
- Also covers Data & Retrieval.
- pdf-reader-mcp ships an MCP server manifest.
- When working within environments that integrate Claude, Cursor, VS Code, or any other MCP client where precision in extracting visual crops and ensuring provenance through OCR is required.

## When NOT to use ChatFiles

- If you aim to use languages other than TypeScript for your document chatbot functionality.
- Your deployment preferences prioritize platforms other than Vercel, which is highlighted in ChatFiles' documentation.
- The project does not require or benefit from the specific combination of LangchainJS and Supabase as provided by this tool.

## When NOT to use pdf-reader-mcp

- For situations where you do not require the specific capabilities like evidence-first extraction or trust reporting that distinguish pdf-reader-mcp from other general OCR tools.
- In scenarios where only plain text extraction is needed without advanced features such as document intelligence, visual crops, or PDF to Markdown conversion.

## Common questions

### What is the difference between ChatFiles and pdf-reader-mcp?

ChatFiles: Document Chatbot powered by GPT and Embedding. pdf-reader-mcp: PDF intelligence layer for AI agents providing features such as evidence-first extraction and OCR. See the comparison table for live GitHub stats and shared categories.

### When should I choose ChatFiles over pdf-reader-mcp?

Choose ChatFiles over pdf-reader-mcp when Pricing: Available under the MIT license, it is free to use. However, users might incur costs for hosting with Vercel and database usage on Supabase.; Requirements: Local setup requires setting environment variables as outlined in the documentation.; Tags unique to ChatFiles: chatbot, embedding, gpt-api, supabase; Also covers Vector Databases; ChatFiles ships Docker support for self-hosted deployment; You need to integrate file-based conversations into your web apps using TypeScript.

### When should I choose pdf-reader-mcp over ChatFiles?

Choose pdf-reader-mcp over ChatFiles when Tags unique to pdf-reader-mcp: agent-document-twin, ai-tools, document-intelligence, document-processing; Also covers Data & Retrieval; pdf-reader-mcp ships an MCP server manifest; When working within environments that integrate Claude, Cursor, VS Code, or any other MCP client where precision in extracting visual crops and ensuring provenance through OCR is required.

### When should I avoid ChatFiles?

If you aim to use languages other than TypeScript for your document chatbot functionality. Your deployment preferences prioritize platforms other than Vercel, which is highlighted in ChatFiles' documentation. The project does not require or benefit from the specific combination of LangchainJS and Supabase as provided by this tool.

### When should I avoid pdf-reader-mcp?

For situations where you do not require the specific capabilities like evidence-first extraction or trust reporting that distinguish pdf-reader-mcp from other general OCR tools. In scenarios where only plain text extraction is needed without advanced features such as document intelligence, visual crops, or PDF to Markdown conversion.

### Is ChatFiles or pdf-reader-mcp more popular on GitHub?

ChatFiles has more GitHub stars (3,337 vs 935). Stars measure visibility, not whether either tool fits your constraints.

### Are ChatFiles and pdf-reader-mcp open source?

Yes - both are open-source projects on GitHub (ChatFiles: MIT, pdf-reader-mcp: MIT).

### Where can I find alternatives to ChatFiles or pdf-reader-mcp?

GraphCanon lists graph-backed alternatives at [ChatFiles alternatives](/tools/guangzhengli-chatfiles/alternatives) and [pdf-reader-mcp alternatives](/tools/sylphxai-pdf-reader-mcp/alternatives) ([ChatFiles markdown twin](/tools/guangzhengli-chatfiles/alternatives.md), [pdf-reader-mcp markdown twin](/tools/sylphxai-pdf-reader-mcp/alternatives.md)), ranked by typed relationship edges rather than popularity votes.

### Is there a machine-readable version of this comparison?

Yes. The markdown twin at [this comparison](/compare/guangzhengli-chatfiles-vs-sylphxai-pdf-reader-mcp.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers.

### Which is better maintained, ChatFiles or pdf-reader-mcp?

ChatFiles: Dormant. pdf-reader-mcp: Very active. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance.

### Where are the full trust reports for ChatFiles and pdf-reader-mcp?

GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [ChatFiles trust report](/tools/guangzhengli-chatfiles/trust); [pdf-reader-mcp trust report](/tools/sylphxai-pdf-reader-mcp/trust).

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/graph?tool=guangzhengli-chatfiles`](/api/graphcanon/graph?tool=guangzhengli-chatfiles)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_
