Citra
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает локальные файлы PDF
- Запускает локальный сервер с нативным движком
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/citraОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio citra -- npx -y @sylphx/citra@6.0.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"citra","type":"stdio","command":"npx","args":["-y","@sylphx/citra@6.0.0"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"citra": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add citra -- npx -y @sylphx/citra@6.0.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.citra]
command = "npx"
args = ["-y", "@sylphx/citra@6.0.0"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"citra": {
"type": "local",
"command": [
"npx",
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"citra": {
"command": "npx",
"args": [
"-y",
"@sylphx/citra@6.0.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавь MCP-сервер: npx -y @sylphx/citra. Ключ и Docker не нужны, сервер работает локально по stdio.
Другие способы из описания автора
npx -y @sylphx/citraЗапускает MCP-сервер по stdio, ключ и Docker не нужны.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Citra дает агенту работать с PDF по существу. Сервер извлекает структурный текст и таблицы, распознает текст на сканах через OCR и умеет отдавать визуальные вырезки страниц как доказательство. Ключевая идея в цитировании: ответы привязываются к конкретным страницам, чтобы агент мог подтвердить, откуда взята информация, а не выдумывать. Работает локально, без Docker и без ключа: команда запускает MCP-сервер по stdio, который сразу доступен агенту. Внутри нативный движок на Rust, есть также CLI и SDK с теми же инструментами чтения, поиска и сбора доказательств.
Для кого. Для тех, кто дает агенту работать с документами PDF и хочет проверяемые ответы со ссылкой на страницу.
Подходит, если
- Нужно, чтобы агент читал PDF с таблицами и сканами
- Нужны ответы с цитатами и ссылкой на страницу
- Хочется локальную обработку документов без ключа
Не подходит, если
- Документы не в PDF
- Нужен полноценный поиск по большой библиотеке, а не чтение отдельных файлов
Пример запроса к агенту
Прочитай этот PDF-отчет, найди таблицу с расходами и дай ответ со ссылкой на страницуОграничения
Сервер работает с PDF и опирается на нативный пакет под вашу платформу, который ставится автоматически. Качество OCR зависит от исходного скана. Это чтение и извлечение из отдельных документов, а не готовое хранилище для RAG.
Как отключить. Удалите сервер citra из конфигурации MCP.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Читает локальные файлы PDF
- Запускает локальный сервер с нативным движком
Коротко о README
README представляет Citra как локальный MCP-сервер, который дает агенту читать PDF с доказательствами: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы. Запуск в одну команду npx без Docker и ключа, есть конфигурации для Claude Desktop, Cursor, VS Code и Codex. Внутри нативный движок на Rust, доступны CLI и SDK с теми же инструментами read, search и evidence. Лицензия MIT.
Частые вопросы
Нужен ли ключ или Docker?
Нет, запуск в одну команду npx, сервер работает локально по stdio без ключа и Docker.
Как он помогает не выдумывать?
Ответы привязываются к страницам PDF, поэтому агент может показать источник, а не сочинить его.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов