Install
pip install humanizer-ru누구에게 맞나
채팅 화면에서 붙여 넣은 러시아어를 먼저 대조 가능한 위생 검사한 뒤 polish 할지 결정하려는 사람에게 맞다. humanizer-ru는 러시아어 텍스트를 대상으로 검증 가능한 붙여넣기 위생 처리를 제공한다. MCP로 갈 때 같은 명령 집합이 stdio의 humanizer-mcp로 노출되며 contract.v1.json의 도구에 대응한다. 텍스트는 이 프로세스에 남고 이 도구 집합이 프로세스 밖으로 보내지 않는다.
주로 Markdown 원고를 다루고 바로 polish를 돌리려는 사람에게는 맞지 않다. polish는 ##, **, 서명호식 따옴표와 대시를 벗긴다. --preserve-markup가 있을 때만 표시가 있는 텍스트에 polish를 해도 된다. Python 패키지를 아직 설치하지 않고 클라이언트 설정만 바꾸는 사람에게도 맞지 않다. 서비스 명령은 설치 후의 humanizer-mcp다.
3분 만에 첫 시도 마치기
공식 경로는 하나다: 먼저 패키지를 설치하고 유일한 MCP 설정을 humanizer-mcp로 쓴다. 두 번째 설치기를 나란히 두지 않는다.
pip install humanizer-ru
클라이언트 설정 위치는 MCP 서버 표의 이 항목이다:
{
"mcpServers": {
"humanizer-ru": { "command": "humanizer-mcp" }
}
}
전제: 이 기기에 pip을 돌릴 Python이 있고 stdio MCP를 시작할 클라이언트가 있다. 설정에 키 자리 표시를 넣지 않는다. 이 서비스는 API key를 요구하지 않는다.
첫 호출은 원문에 적힌 스캔 명령을 쓴다. 먼저 표시를 보고 아직 polish하지 않는다. 원문대로 샘플을 준비하고 스캔한다:
python -c "open('primer.txt','w',encoding='utf-8').write('Согласно отчёту :contentReference[oaicite:3]{index=3}, рост заявок.\n')"
humanizer-markers --scan primer.txt; echo "rc=$?"
성공은 명령이 끝나고 rc= 뒤에 종료 코드를 찍으며, 스캔이 샘플의 채팅 잔여를 표시했는지 보이는 것이다. MCP 쪽에서는 같은 명령이 JSON-RPC 봉투로 가고 오류는 계약대로 isError다. 로컬 파일을 읽고 스캔하는 것이며 위험이 0은 아니다. 이 기기에 primer.txt를 쓰고 그 파일을 읽는다.
스캔이 되면 polish가 필요할 때 MCP 도구 humanizer_polish를 고려한다. Markdown에는 반드시 --preserve-markup를 붙인다. 없으면 제목과 굵게 표시를 벗긴다.
사용 사례
사례 1: 채팅 붙여넣기의 잔여 표시를 검사한다. humanizer-markers --scan(MCP에서도 같은 명령 집합)으로 편집기에 방금 붙인 러시아어를 스캔한다. “채팅 인용 찌꺼기가 있는지”를 먼저 확인한 뒤 고치는 용도다. 출처는 primer.txt 스캔과 종료 코드만 보여 주며 모든 표시 종류를 나열하지 않는다.
사례 2: 조판 원고가 아님을 확인한 뒤 사실 대조 또는 polish. MCP는 humanizer_facts와 CLI와 같은 형태의 humanizer_polish를 제공한다. polish를 Markdown에 바로 치지 않는다. 표시를 남길 때는 --preserve-markup. 출처에 이 두 도구의 매개변수 표는 없다. 없으면 이름과 위 제한에서 멈춘다.
사용 경계
패키지 이름은 humanizer-ru, MCP 프로세스는 humanizer-mcp, 계약은 contract.v1.json. 텍스트는 프로세스를 떠나지 않지만 로컬 파일은 읽고 primer.txt 같은 샘플을 쓸 수 있다. polish는 --preserve-markup가 없으면 Markdown을 깨뜨린다. 출처에 철회 경로는 없다. JSON-RPC 오류는 isError를 본다. 공식 설명:
https://github.com/Vladimir-Human/humanizer-ru