faxin-mcp（法信 MCP 커넥터 · 공개 버전）

法信（法律出版社 산하의 법률 검색 플랫폼）을 MCP(Model Context Protocol) 서비스로 캡슐화하여, MCP를 지원하는 모든 AI 클라이언트(Claude Desktop, Cherry Studio, 각종 coding agent 등)가 중국 법률·법규, 재판 규칙, 法信 대강 개념, 유사 사례(권위 사례 라이브러리) 등을 직접 검색할 수 있게 합니다.

작동 원리: 로그인은 사용자 본인이 팝업된 브라우저에서 자신의 法信 공식 사이트 계정으로 완료합니다. 이후 모든 검색과 상세 읽기는 해당 세션 cookie를 포함한 순수 HTTP 호출입니다(브라우저는 cookie 컨테이너일 뿐 페이지를 렌더링하지 않음). 단일 검색은 약 2~8초가 소요됩니다.

기능(9개 도구)

Related MCP server: LexLink

설치

# 1. 克隆本仓库
git clone <repo-url>
cd faxin-mcp-public

# 2. 建虚拟环境并装依赖
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

# 3. 安装 Playwright 浏览器
.venv/bin/playwright install chromium

최초 로그인

.venv/bin/python login.py

• 브라우저 창이 팝업됩니다 → 法信 공식 사이트를 엽니다 → 「로그인」을 클릭합니다 → 사용자 본인의 法信 계정으로 로그인을 완료합니다(아이디·비밀번호 / SMS 인증번호 / QR코드, 공식 사이트에서 제공하는 로그인 방식에 따름);

• 페이지에 로그인 상태가 표시되는지 확인한 후, 터미널로 돌아가 Enter를 눌러 세션을 저장합니다;

• 스크립트가 자동으로 한 번 헤드리스 재사용을 검증합니다. 이후 정상 사용 중에는 다시 로그인할 필요가 없습니다. 세션이 만료되면(도구가 알림) 이 스크립트를 다시 실행하면 됩니다.

이 스크립트는 사용자의 아이디·비밀번호를 읽거나 기록하거나 업로드하지 않습니다. 모든 자격 증명은 오직 法信 공식 사이트 페이지를 통해서만 처리됩니다.

MCP 클라이언트 설정

Claude Desktop(claude_desktop_config.json)을 예로 들면:

{
  "mcpServers": {
    "faxin": {
      "type": "stdio",
      "command": "/你的路径/faxin-mcp-public/.venv/bin/python",
      "args": ["/你的路径/faxin-mcp-public/server.py"]
    }
  }
}

다른 MCP 클라이언트(Cherry Studio 등)도 동일합니다: python 인터프리터 경로 + server.py 경로만 입력하면 됩니다.

선택적 환경 변수

사용 제안(키워드 전략)

• 검색은 사건 유형 용어(예: 「매매계약 분쟁」「민간 대차 분쟁») 또는 법조문 원문 표현(예: 「공·사유 재물 절취」)을 우선 사용하세요. 추상적인 법률 개념은 적중률이 낮습니다.

• 법조문을 찾을 때: 법규명+조항 번호를 알고 있으면 faxin_get_tiao를 바로 사용하고(가장 빠름), 주제어만 알면 faxin_search_law를 사용하세요.

• 어떤 검색어로 검색할지 모를 때는 먼저 faxin_search_outline으로 개념 발견을 한 다음, 개념별로 집계된 각 라이브러리 수치에 따라 라이브러리를 선택해 심층 탐색하세요.

• 재판 규칙 라이브러리가 커서 단일 검색에 7~17초가 걸리는 것은 정상입니다. 낮은 빈도로 사용하고, 고빈도로 연속 호출하지 마세요(플랫폼이 일시적으로 속도 제한을 걸며, 약 60초 쿨다운 후 자동으로 회복됩니다).

메인 사이트 호환성 실측(2026-08-22, www.faxin.cn 익명 + 로그인 상태 이중 탐지)

익명 접근 가능(로그인 불필요):

로그인 후 검증(개인 法信 계정 실측):

결론: 메인 사이트 인터페이스 경로는 변호사협회 VIP 버전과 동일한 구조입니다. 법규 검색/법조문 바로가기/대강/상세 읽기는 로그인 후 바로 사용할 수 있습니다. 재판 규칙 라이브러리는 계정 권한에 의해 제한됩니다(커넥터와 무관). 유사 사례 검색은 메인 사이트 token 메커니즘 차이로 현재 지원되지 않습니다(변호사협회 버전에서는 정상).

⚠️ 규정 준수 고지(사용 전 필독)

이 프로젝트는 단지 MCP 프로토콜 어댑터 계층이며, 역할과 경계는 다음과 같습니다.

1. 어떠한 인증도 우회하지 않습니다. 로그인은 사용자 본인이 팝업된 브라우저에서 자신의 法信 계정으로 완료해야 합니다. 이 프로젝트에는 크래킹, 모의 로그인, 캡차 인식 또는 암호화 알고리즘 분석 코드가 포함되어 있지 않습니다.

2. 어떠한 탐지 또는 안티크롤링 조치도 회피하지 않습니다. 이 프로젝트는 자동화 특성을 숨기는 시작 매개변수나 스크립트 주입을 사용하지 않습니다.

3. 권한을 넘어선 접근을 하지 않습니다. 사용자 계정 권한 내의 콘텐츠에만 접근합니다. 일부 라이브러리(예: 재판 규칙 라이브러리, 유사 사례 라이브러리)는 法信 유료 계정이 있어야 전체 접근이 가능할 수 있습니다. 실제 권한은 사용자 계정 기준을 따르세요.

4. 대량 수집을 하지 않으며 로컬 데이터베이스를 구축하지 않습니다. 온디맨드 단일 검색만 제공합니다. 낮은 빈도로 사용하고, 法信 플랫폼 사용자 약관과 robots 규칙을 준수하세요.

5. 이 프로젝트가 중개하는 콘텐츠의 저작권은 원 플랫폼에 있습니다. 검색 결과는 개인 연구·학습 목적으로만 사용할 수 있으며, 상업적 재판매에는 사용할 수 없습니다.

면책 조항

• 이 프로젝트는 개인 학습·교류 성격의 오픈소스 도구이며, 法信 플랫폼과 어떠한 소속 또는 승인 관계도 없습니다.

• 法信 플랫폼의 페이지 구조와 인터페이스는 수시로 변경될 수 있으며, 이 프로젝트는 장기적인 사용 가능성을 보장하지 않습니다.

• 사용자는 자신의 사용 행위가 法信 플랫폼 사용자 약관 및 관련 법률·규정을 준수하는지 스스로 확인해야 하며, 이 프로젝트 사용으로 인한 모든 결과는 사용자가 부담합니다.

• 검색 결과는 참고용일 뿐이며 법률 의견을 구성하지 않습니다. 법규 조문을 공식적으로 인용할 때는 공식 발표 텍스트를 기준으로 하십시오.

• 누구든 이 코드를 수정(fork 후 2차 개발 등)하여 재배포하거나 사용하는 경우, 그 수정 부분 및 사용 행위로 인한 모든 법적 위험은 수정자/사용자가 부담하며 원본 저자와 무관합니다.

• 이 프로젝트에는 대량 수집, 안티탐지, 크래킹 기능이 포함되어 있지 않습니다. 法信 플랫폼이 사용자 약관을 업데이트하여 자동화 도구를 통한 인터페이스 호출을 명시적으로 금지하는 경우, 사용자는 이 프로젝트 사용을 스스로 중단해야 하며, 원본 저자는 이에 대해 어떠한 책임도 지지 않습니다.

라이선스

MIT License(LICENSE 참조). 法信 플랫폼 콘텐츠의 저작권은 이 프로젝트의 MIT 라이선스로 인해 변경되지 않습니다.