CLI-интерфейс Markovo и MCP-сервер

Markovo превращает поддерживаемые файлы и явно авторизованные публичные HTTPS-страницы в чистый, структурированный Markdown. Для полноценного веб-интерфейса и подробностей о продукте посетите PDF to Markdown Converter.

Этот публичный репозиторий является источником распространения клиентского CLI markovo и stdio MCP-сервера markovo-mcp. Он не содержит локального движка конвертации, серверной службы, конфигурации развертывания, производственных учетных данных или реализации биллинга. Конвертация выполняется через сервис с учетом использования аккаунта по адресу https://markovo.net.

Установка

pip install markovo

Или запустите его без постоянной установки:

uvx markovo --help
uvx --from markovo markovo-mcp

Related MCP server: MarkItDown MCP Server

API-ключ и кредиты

1. Создайте API-ключ в портале разработчика.

2. Храните его в вашей оболочке или в хранилище секретов MCP-хоста; не вставляйте его в подсказки и не фиксируйте в системе контроля версий.

3. Проверьте настройку:

export MARKOVO_API_KEY="your-key"
markovo doctor --json

Каждая конвертация требует явного лимита кредитов. Если ключ отсутствует, клиент указывает на портал разработчика. Если кредитов недостаточно, ответ сервиса указывает на страницу биллинга, чтобы счет можно было пополнить перед повторной попыткой.

Конфигурация MCP

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "markovo-mcp"],
      "env": {
        "MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
        "MARKOVO_MCP_ROOT": "/path/to/safe/project"
      }
    }
  }
}

MCP-клиенты должны внедрять MARKOVO_API_KEY через свои настройки секретов или переменных окружения. Ключ и источник сервиса никогда не являются аргументами инструментов MCP, поэтому подсказки не могут перенаправить учетные данные. Публичный клиент принимает только https://markovo.net и не следует за аутентифицированными перенаправлениями.

MCP-сервер может читать и записывать только в пределах обязательного MARKOVO_MCP_ROOT. Установите его на наименьший выделенный каталог проекта, необходимый вашему MCP-хосту. Если он отсутствует, сервер отказывает во всех файловых инструментах; выходы в родительские каталоги и через символьные ссылки отклоняются.

export MARKOVO_MCP_ROOT="/path/to/safe/project"

Структурированные ошибки указывают на портал разработчика, когда ключ отсутствует, и на биллинг, когда кредитов недостаточно.

Ссылки

• Домашняя страница Markovo

• PDF to Markdown

• Документация

• Цены и кредиты

• Портал разработчика и API-ключи

• Биллинг и пополнение

Безопасность

Сообщайте о проблемах безопасности конфиденциально, следуя инструкциям в SECURITY.md. Не включайте API-ключи, документы клиентов или частные результаты конвертации в публичные обращения.