Suppr MCP — Руководство пользователя | MCP-сервис для перевода документов и поиска в Pubmed на китайском языке | Suppr Super Literature

Suppr MCP Server

Suppr (Super Literature) — это платформа академических инструментов на базе ИИ от WildData. Этот MCP-сервер предоставляет ИИ-ассистентам возможности перевода документов и поиска литературы.

🌐 ИИ-перевод документов — перевод документов PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), TXT и HTML на 13 языков. Сохраняет исходное форматирование. Автоматическое определение языка оригинала.

🔬 Академический поиск в PubMed — семантический поиск литературы по миллионам биомедицинских научных статей. Возвращает структурированные метаданные: DOI, PMID, импакт-фактор журнала, количество цитирований, аффилиации авторов, аннотации и прямые ссылки на статьи.

🤖 Совместимость с MCP — работает с Claude Desktop, Cursor, Windsurf и любым клиентом Model Context Protocol.

Установка

npx suppr-mcp

Быстрый старт

1. Установка

Глобальная установка:

npm install -g suppr-mcp

Или используйте npx (без установки):

npx suppr-mcp

2. Получение API Key

Посетите Suppr API, чтобы получить свой API-ключ.

3. Настройка переменных окружения

export SUPPR_API_KEY=your_api_key_here

4. Использование в MCP-клиенте

Настройка Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или соответствующий файл конфигурации:

{
  "mcpServers": {
    "suppr": {
      "command": "npx",
      "args": ["-y", "suppr-mcp"],
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

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

{
  "mcpServers": {
    "suppr": {
      "command": "suppr-mcp",
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Доступные инструменты

1. create_translation — создание задачи перевода

Создание задачи на перевод документа.

Параметры:

• file_path (выберите либо file_path, либо file_url): путь к исходному файлу

• file_url (выберите либо file_path, либо file_url): URL документа для перевода

• to_lang (обязательно): код целевого языка

• from_lang (опционально): код исходного языка (по умолчанию — автоопределение)

• optimize_math_formula (опционально): оптимизация математических формул (только для PDF)

Пример:

{
  "file_url": "https://example.com/document.pdf",
  "to_lang": "en",
  "from_lang": "zh",
  "optimize_math_formula": true
}

Ответ:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "INIT",
  "consumed_point": 453,
  "source_lang": "zh",
  "target_lang": "en",
  "optimize_math_formula": true
}

2. get_translation — получение деталей перевода

Получение подробной информации и статуса задачи перевода.

Параметры:

• task_id (обязательно): ID задачи перевода

Пример:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1"
}

Ответ:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "DONE",
  "progress": 1.0,
  "consumed_point": 453,
  "source_file_name": "document.pdf",
  "source_file_url": "https://example.com/source.pdf",
  "target_file_url": "https://example.com/translated.pdf",
  "source_lang": "zh",
  "target_lang": "en",
  "error_msg": null,
  "optimize_math_formula": true
}

Описание статусов задачи:

• INIT: Инициализация

• PROGRESS: В процессе

• DONE: Завершено

• ERROR: Ошибка

3. list_translations — список задач перевода

Получение списка задач перевода с поддержкой пагинации.

Параметры:

• offset (опционально): смещение пагинации, по умолчанию 0

• limit (опционально): количество на страницу, по умолчанию 20

Пример:

{
  "offset": 0,
  "limit": 10
}

Ответ:

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "list": [
    {
      "task_id": "...",
      "status": "DONE",
      "progress": 1.0,
      ...
    }
  ]
}

4. search_documents — поиск литературы

Семантический поиск литературы на базе ИИ.

Параметры:

• query (обязательно): запрос на естественном языке

• topk (опционально): максимальное количество результатов (1-100, по умолчанию 20)

• return_doc_keys (опционально): указание возвращаемых полей

• auto_select (опционально): автоматический выбор оптимальных результатов (по умолчанию true)

Пример:

{
  "query": "糖尿病最新研究进展",
  "topk": 5,
  "return_doc_keys": ["title", "abstract", "doi", "authors"],
  "auto_select": true
}

Доступные поля для возврата:

• title: заголовок

• abstract: аннотация

• authors: список авторов

• doi: DOI

• pmid: PubMed ID

• link: ссылка

• publication: издание

• pub_year: год публикации

• Дополнительные поля см. в документации API

Ответ:

{
  "search_items": [
    {
      "doc": {
        "title": "...",
        "abstract": "...",
        "authors": [...],
        "doi": "...",
        ...
      },
      "search_gateway": "pubmed"
    }
  ],
  "consumed_points": 20
}

Поддерживаемые языки

Коды распространенных языков:

• en: English (английский)

• zh: Chinese (китайский)

• ko: Korean (корейский)

• ja: Japanese (японский)

• fr: French (французский)

• de: German (немецкий)

• es: Spanish (испанский)

• ru: Russian (русский)

• ar: Arabic (арабский)

• pt: Portuguese (португальский)

• it: Italian (итальянский)

• auto: автоопределение

Обработка ошибок

Все ошибки возвращаются в стандартном формате:

{
  "code": 非零错误码,
  "msg": "错误信息",
  "data": null
}

Распространенные ошибки:

• 401: API-ключ недействителен или не предоставлен

• 400: Ошибка параметров запроса

• 404: Ресурс не найден

Примеры использования

Использование в Claude Desktop

1. После настройки API-ключа перезапустите Claude Desktop

2. Используйте инструменты в диалоге:

Перевод документа:

Пожалуйста, переведи этот документ: https://example.com/paper.pdf на английский язык

Поиск литературы:

Помоги найти новейшую литературу по теме "применение глубокого обучения в медицинской визуализации"

Запрос статуса перевода:

Проверь прогресс перевода для задачи 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1

Часто задаваемые вопросы

В: Как получить API-ключ?

О: Посетите https://suppr.wilddata.cn/api-keys, чтобы зарегистрироваться и получить API-ключ.

В: Какие форматы документов поддерживаются?

О: Поддерживаются PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB и другие распространенные форматы.

В: Сколько времени занимает перевод?

О: Зависит от размера документа, обычно от нескольких минут до десяти с лишним минут. Вы можете использовать get_translation для проверки прогресса.

В: Как скачать переведенный документ?

О: После завершения перевода get_translation вернет target_file_url, перейдите по этой ссылке для скачивания.

В: npx не запускается?

О: Убедитесь, что версия Node.js >= 18.0.0 и установлена переменная окружения SUPPR_API_KEY.

🔗 Продукты Suppr Super Literature

• Плагин Zotero : https://github.com/WildDataX/suppr-zotero-plugin

• Официальный сайт: https://suppr.wilddata.cn

• ИИ-перевод документов: https://suppr.wilddata.cn/translate/upload

• API-сервис: https://openapi.suppr.wilddata.cn/introduction

• Поиск в Pubmed на китайском: https://suppr.wilddata.cn/

• Глубокое исследование: https://suppr.wilddata.cn/deep-research

• GitHub-организация: WildDataX

Техническая поддержка

Если вам нужна помощь, свяжитесь с нами: IT@wilddata.cn

Сделано с ❤️ компанией WildData

Экосистема Suppr