Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-15 05:22 UTC

jztan / pdf-mcp

An MCP server that gives your AI agent agentic RAG over your PDFs, one file or a whole folder: hybrid semantic + keyword search, selective page reads, tables, images, OCR, chart data, and multi-column/CJK layouts. The agent decides when to search; pdf-mcp does the retrieval.

PythonMIT★ 134 зірки⑂ 13 форківз січ. 2026 р.Переглянути на GitHub ↗

ТипMCP-серверІнструмент командного рядкаБібліотекаяк це визначено

#ai #claude #document-processing #llm #mcp #pdf #python #codex-cli #opencode #mcp-server #cjk #ocr #pdf-extraction #pymupdf #semantic-search #table-extraction #agentic-rag #claude-code #model-context-protocol #rag

jztan/pdf-mcp має індекс здоров’я 90 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (92/100), найнижчий — Sustainability & Governance (59/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям

Відмінний80-92Сильний за всіма напрямами; незначні прогалини

Добрий65-79Здоровий; прогалини обмежені та керовані

Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку

Слабкий35-49Суттєві недоліки в кількох сферах

У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності

Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 76 калібровано до 90 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

jztanОсобистий обліковий запис

12 підписників24 публічні репозиторіїз лист. 2013 р.

Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.

Пакетні екосистеми

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
PyPI	pdf-mcp	3.2.0	6 229	33	3 дні тому	ai ai-agent anthropic claude document-ai document-processing llm mcp model-context-protocol pdf pdf-extraction pdf-reader

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

92Відмінний · 21% загального індексу

Активність розробки

86Відмінний

Як обчислюється оцінка

36/36	Свіжість push — останній push 0 дн. тому
21.5/36	Ритм комітів — 31/52 тижнів із комітами
18/18	Обсяг комітів — 1 562 комітів за останній рік
10/10	OpenSSF Scorecard: Maintained — 30 commit(s) and 14 issue activity found in the last 90 days -- score normalized to 10

Використані вхідні дані

commits_last_year	1 562
human_commit_share	1
days_since_last_push	0
active_weeks_last_year	31

Дисципліна релізів

100Винятковий

Як обчислюється оцінка

27/27	Випускає релізи — опубліковано 32 релізів
36/36	Свіжість релізів — останній реліз 3 дн. тому
27/27	Ритм релізів — реліз кожні ~7 дн.
0/10	OpenSSF Scorecard: Signed-Releases — немає даних

Використані вхідні дані

releases_count	32
latest_release_tag	v3.2.0
releases_from_tags	ні
days_since_latest_release	3
mean_days_between_releases	7

Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

66Добрий · 17% загального індексу

Здоров'я спільноти

92Відмінний

Як обчислюється оцінка

22.5/22.5	README
22.5/22.5	Ліцензія — визнана ліцензія (MIT)
18/18	Настанови CONTRIBUTING
13.5/13.5	Кодекс поведінки
0/7.2	Шаблон issue
6.3/6.3	Шаблон PR

Використані вхідні дані

has_readme	так
has_license	так
readme_badges	6
has_contributing	так
has_issue_template	ні
has_code_of_conduct	так
readme_badge_services	codecov.io, github.com, shields.io
has_pull_request_template	так

Впровадження в екосистемі (завантаження)

63Помірний

Як обчислюється оцінка

50.6/80	Щомісячні завантаження — 6 229 завантажень/місяць у pypi
0/20	Залежні пакети в реєстрі — ця екосистема цього не повідомляє

Використані вхідні дані

packages	pdf-mcp
dependents	—
ecosystems	pypi
total_downloads	—
monthly_downloads	6 229
unverified_packages_excluded	—

Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

59Помірний · 23% загального індексу

Стійкість мейнтейнерів (бас-фактор)

25У зоні ризику

Як обчислюється оцінка

9/54	Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
0.5/22.5	Розподіл комітів — головний контриб’ютор — автор 98% комітів
5.4/13.5	Широта контриб’юторів — 4 контриб’юторів
10/10	OpenSSF Scorecard: Contributors — project has 3 contributing companies or organizations -- score normalized to 10

Використані вхідні дані

bus_factor	1
contributors_sampled	4
top_contributor_share	0,98

Реактивність на issue та PR

76Добрий

Як обчислюється оцінка

39.9/42	Вирішення issue — закрито 95% issue
24/30	Прийняття PR — злито 24/30 вирішених PR
10.4/13	Newcomer PR acceptance — злито 4/5 PR від новачків за 30 дн.
1.5/15	OpenSSF Scorecard: Code-Review — Found 3/18 approved changesets -- score normalized to 1

Використані вхідні дані

merged_prs	24
open_issues	1
closed_issues	19
prs_merged_7d	5
prs_decided_7d	6
prs_merged_30d	16
prs_decided_30d	17
issue_closed_ratio	0,95
closed_unmerged_prs	6
first_time_authors_30d	2
first_time_prs_merged_30d	4
first_time_prs_decided_30d	5

Власність та опіка

50Помірний

Як обчислюється оцінка

10/30	Підтримка власника — особистий (користувацький) обліковий запис
0/20	Верифікований домен — не застосовно до користувацьких облікових записів
8/25	Охоплення власника — 12 підписників у jztan
22.2/25	Послужний список — 24 публічних репозиторіїв, вік облікового запису ~12 р.

Використані вхідні дані

followers	12
owner_type	User
is_verified	—
owner_login	jztan
public_repos	24
account_age_days	4 678

Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

Супровід пакетів

100Винятковий

Як обчислюється оцінка

25/25	Опубліковано й доступно — 1 пакет(ів) у pypi
35/35	Свіжість публікацій — остання публікація 3 дн. тому
20/20	Історія версій — 33 опублікованих версій
20/20	Не застарілий — активний, не deprecated і не yanked

Використані вхідні дані

packages	pdf-mcp
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	3

Інженерна якість

Чи наявні базові інженерні практики та документація?

92Відмінний · 19% загального індексу

Інженерні практики

94Винятковий

Як обчислюється оцінка

24/24	Процеси CI — 6 процес(ів) CI
24/24	Наявні тести
16/16	Конфігурація лінтера — .flake8, pyproject.toml ([tool.black])
9.6/9.6	Pre-commit-хуки
0/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 5 out of 5 merged PRs checked by a CI test -- score normalized to 10

Використані вхідні дані

has_ci	так
has_tests	так
has_editorconfig	ні
has_linter_config	так
has_precommit_config	так

Документація

90Відмінний

Як обчислюється оцінка

30/30	README
25/25	Каталог документації
15/15	Сайт документації / домашня сторінка — https://pdf-mcp.jztan.com
10/10	Опис репозиторію
10/10	Теми — 20 тем
0/10	Wiki

Використані вхідні дані

topics	ai, claude, document-processing, llm, mcp, pdf, python, codex-cli, opencode, mcp-server, cjk, ocr, pdf-extraction, pymupdf, semantic-search, table-extraction, agentic-rag, claude-code, model-context-protocol, rag
has_wiki	ні
homepage	https://pdf-mcp.jztan.com
docs_site	https://pdf-mcp.jztan.com
has_readme	так
has_docs_dir	так
has_description	так

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

75Добрий · 16% загального індексу

Стан безпеки

69Добрий

Як обчислюється оцінка

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — branch protection not enabled on development/release branches
2.5/2.5	CI-Tests — 5 out of 5 merged PRs checked by a CI test -- score normalized to 10
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0.8/7.5	Code-Review — Found 3/18 approved changesets -- score normalized to 1
2.5/2.5	Contributors — project has 3 contributing companies or organizations -- score normalized to 10
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
0/5	Fuzzing — project is not fuzzed
2.5/2.5	Ліцензія — license file detected
7.5/7.5	Maintained — 30 commit(s) and 14 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
2.5/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 5
0/5	SAST — SAST tool is not run on all commits -- score normalized to 0
5/5	Security-Policy — security policy file detected
0/7.5	Signed-Releases — немає даних
7.5/7.5	Token-Permissions — GitHub workflow tokens follow principle of least privilege
6.8/7.5	Vulnerabilities — 1 existing vulnerabilities detected

Використані вхідні дані

source	openssf_scorecard
checks_evaluated	17
scorecard_version	v5.5.0
checks_inconclusive	1
scorecard_aggregate	6,9

Виключено з оцінювання (немає даних або не застосовно): Signed-Releases. Залишкові ваги перенормовано.

Сповіщення про залежності

100Винятковий

Як обчислюється оцінка

35/35	Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25	Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40	Немає задавнених сповіщень — жодне сповіщення не має дати публікації

Використані вхідні дані

source	osv
advisories	0
affected_packages	0
assessed_packages	91
unassessed_packages	0
affected_by_severity	none
direct_affected_packages	0

Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:pdf-mcp@3.2.0 — тим, що тягне за собою встановлення опублікованого пакета, — 91 пакетів. Досяжність не аналізується.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

60Помірний · 4% загального індексу

Контекст і настанови для агентів

40Слабкий

Як обчислюється оцінка

0/45	Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
0/15	Машиночитана документація (llms.txt)
40/40	Читабельна історія комітів — намір зазначено у 75 з 100 людських комітів (структурований заголовок або пояснювальний текст)

Використані вхідні дані

has_llms_txt	ні
llms_txt_url	—
legible_history_share	0,75
agent_instruction_files	—
agent_instruction_max_bytes	—

Цикл верифікації (збірка / тести / перевірка типів)

63Помірний

Як обчислюється оцінка

0/18	Розгортання однією командою
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — .flake8, pyproject.toml ([tool.black])
0/11	Статична перевірка типів
10/10	Відтворюване середовище — Dockerfile, lockfile
10/10	Підтверджена практика роботи з агентами — 18 з останніх 100 комітів створено агентом або з його зазначенням
5/8	Автоматизоване супроводження — автоматизацію залежностей налаштовано, але у вибірці комітів її не видно
5/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 5

Використані вхідні дані

has_nix	ні
has_tests	так
lockfiles	uv.lock
has_dockerfile	так
typed_language	ні
bootstrap_files	—
has_devcontainer	ні
has_linter_config	так
typecheck_configs	—
agent_commit_share	0,18
toolchain_manifests	—
dependency_bot_commit_share	0

Читабельність коду для моделей

53Помірний

Як обчислюється оцінка

0/45	Типізований код — Python без конфігурації перевірки типів
52.8/55	Керовані розміри файлів — 9/224 файлів вихідного коду понад 60 КБ

Використані вхідні дані

primary_language	Python
largest_source_bytes	279 067
source_files_sampled	224
oversized_source_files	9

Машиночитні інтерфейси

100Винятковий

Як обчислюється оцінка

0/40	Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
20/20	Сервер MCP
40/40	Придатні до запуску приклади — examples

Використані вхідні дані

example_dirs	examples
has_mcp_signal	так
api_schema_files	—
interfaces_expected_of	—

Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

Ключові факти

134зірок GitHub

4контриб'юторів

1 562комітів за останні 12 місяців

0днів від останнього пушу

32релізів

1бас-фактор

1відкритих issue

PyPIпакетних екосистем

Попередження щодо збору даних

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Докладніше

Історія зірок і форків 0 ★ / 13 ⇿

0Зірки

13Форки

26Релізи

Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.

Мажорні 2Мінорні 20Патчі 4

OpenSSF Scorecard 6.9 / 10

6.9сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-15 05:22 UTC

10	Binary-Artifacts	no binaries found in the repo
0	Branch-Protection	branch protection not enabled on development/release branches
10	CI-Tests	5 out of 5 merged PRs checked by a CI test -- score normalized to 10
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
1	Code-Review	Found 3/18 approved changesets -- score normalized to 1
10	Contributors	project has 3 contributing companies or organizations -- score normalized to 10
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
0	Fuzzing	project is not fuzzed
10	License	license file detected
10	Maintained	30 commit(s) and 14 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
5	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 5
0	SAST	SAST tool is not run on all commits -- score normalized to 0
10	Security-Policy	security policy file detected
н/д	Signed-Releases	no releases found
10	Token-Permissions	GitHub workflow tokens follow principle of least privilege
9	Vulnerabilities	1 existing vulnerabilities detected

Прямі залежності 18

Реєстр	Пакет	Обмеження версії	Маніфест
PyPI	fastmcp	`>=3.0.0`	pyproject.toml
PyPI	pydantic	`>=2.0`	pyproject.toml
PyPI	mcp	`>=1.28.1,<2.0`	pyproject.toml
PyPI	numpy	`>=1.24`	pyproject.toml
PyPI	fastembed	`>=0.7,<1.0`	pyproject.toml
PyPI	pydantic-settings	`>=2.14.2`	pyproject.toml
PyPI	joserfc	`>=1.6.7`	pyproject.toml
PyPI	click	`>=8.3.3`	pyproject.toml
PyPI	pygments	`>=2.20.0`	pyproject.toml
PyPI	httpx	`>=0.27.0`	pyproject.toml
PyPI	packaging	`>=23.0`	pyproject.toml
PyPI	tomli	`>=2.0`	pyproject.toml
PyPI	pypdfium2	`>=4.30`	pyproject.toml
PyPI	pdfplumber	`>=0.11`	pyproject.toml
PyPI	pypdf	`>=5.0`	pyproject.toml
PyPI	pytesseract	`>=0.3.10`	pyproject.toml
PyPI	pillow	`>=12.3.0`	pyproject.toml
PyPI	snowballstemmer	`>=2.2.0`	pyproject.toml

Усі залежності не зібрано

Не вдалося зібрати розв'язаний набір залежностей для цього звіту: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Сповіщення про залежності 0

Встановлення pypi:pdf-mcp@3.2.0 тягне 91 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

Жодне відоме сповіщення не стосується оцінених залежностей.

Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.

34.5/60	Зірки — 134 зірок
9/25	Форки — 13 форків
0/15	Спостерігачі — 1 спостерігачів

forks	13
stars	134
watchers	1
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

Індекс здоров'я програмного забезпечення

Профіль оцінок

Власність

Пакетні екосистеми

Метрики за категоріями

Ключові факти

Попередження щодо збору даних

Докладніше

Зворотний зв’язок

Пов’язані записи