Suppr MCP - 사용 가이드 | 문서 번역 및 중국어 PubMed 검색 MCP 서비스 | Suppr 초능력 문헌

Suppr MCP 서버

Suppr (초능력 문헌)은 WildData에서 제공하는 AI 기반 학술 도구 플랫폼입니다. 이 MCP 서버는 AI 어시스턴트에게 문서 번역 및 문헌 검색 기능을 제공합니다.

🌐 AI 문서 번역 — PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), TXT 및 HTML 문서를 13개 언어로 번역합니다. 원본 서식을 유지하며, 소스 언어를 자동으로 감지합니다.

🔬 PubMed 학술 검색 — 수백만 건의 생의학 연구 논문을 대상으로 의미론적 문헌 검색을 수행합니다. DOI, PMID, 저널 영향력 지수(Impact Factor), 인용 횟수, 저자 소속, 초록 및 논문 직접 링크 등 구조화된 메타데이터를 반환합니다.

🤖 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 - 문헌 검색

AI 기반 문헌 의미론적 검색.

매개변수:

• 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의 번역 진행 상황을 확인해줘

자주 묻는 질문

Q: API 키는 어떻게 얻나요?

A: https://suppr.wilddata.cn/api-keys 에 접속하여 등록 후 API 키를 발급받으세요.

Q: 어떤 문서 형식을 지원하나요?

A: PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB 등 일반적인 형식을 지원합니다.

Q: 번역에 얼마나 걸리나요?

A: 문서 크기에 따라 다르며, 보통 몇 분에서 십여 분 정도 소요됩니다. get_translation을 사용하여 진행 상황을 확인할 수 있습니다.

Q: 번역된 문서는 어떻게 다운로드하나요?

A: 번역이 완료되면 get_translation이 target_file_url을 반환하며, 해당 링크에 접속하여 직접 다운로드할 수 있습니다.

Q: npx 실행이 실패합니다.

A: Node.js 버전이 18.0.0 이상인지 확인하고, SUPPR_API_KEY 환경 변수가 설정되었는지 확인하세요.

🔗 Suppr 초능력 문헌 제품

• Zotero 플러그인 : https://github.com/WildDataX/suppr-zotero-plugin

• 공식 웹사이트: https://suppr.wilddata.cn

• AI 문서 번역: 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

Made with ❤️ by WildData

Suppr 생태계