pbu-fsbu-mcp

러시아 회계 기준(PBU·FSBU) 전문을 제공하는 MCP 서버 — 재무부 레지스트리의 전체 29개 PBU 및 FSBU를 조항 단위까지 포함하며, 날짜 기준 및 1C:Бухгалтерия 3.0 구성 객체에 대한 프로젝션을 지원합니다.

"FSBU 6/2020이 잔존가치에 대해 요구하는 사항은 무엇인가" 같은 질문과 "ПараметрыАмортизацииОС 레지스터 뒤에는 어떤 규범이 있는가" 같은 역방향 질문에 답합니다.

빠른 시작

git clone https://github.com/MihasikPro/pbu-fsbu-mcp.git
cd pbu-fsbu-mcp
docker compose -f deploy/compose.local.yml up --build

curl http://127.0.0.1:18010/healthz

{"status":"ok"}가 반환됩니다. MCP 엔드포인트 — http://127.0.0.1:18010/mcp.

코퍼스는 git에 저장되지 않습니다. docker build 단계에서 YAML 소스로부터 생성되며 같은 단계에서 검증기(validator)로 검사되므로, 잘못된 코퍼스는 빌드를 실패시킵니다. 첫 실행 전에 추가로 설치할 것은 없습니다 — Python도 Tesseract도 필요 없습니다.

Related MCP server: onec-meta-mcp

도구

리소스 pbu-fsbu://registry — list_standards를 반복 호출하는 대신 세션 시작 시 한 번만 로드할 수 있는 전체 표준의 간결한 테이블입니다.

내부 구성

표준 29개, 조항 1768개. 재무부 전체 레지스트리: 유효 및 폐지된 PBU와 FSBU, 각각의 개정본 기준.

답변은 항상 날짜 기준입니다. 모든 도구는 on_date를 받아 해당 날짜 기준 표준의 상태를 반환합니다. 이는 장식이 아닙니다: PBU 9/99와 10/99는 2027.01.01에 효력을 상실하고, FSBU 9/2025와 10/2026은 그때부터 효력이 발생하므로, 날짜 없이 답하면 이 지평선 너머에서 틀린 답이 됩니다.

1C 프로젝션은 검증된 것입니다. FSBU 6/2020은 BP 3.0 객체 18개와 연결되며, 각 연결에는 신뢰도 평가와 객체가 규범을 어떻게 구현하는지에 대한 설명이 포함됩니다. 모든 레코드는 verified: true — 사람이 검증했으며 코드만으로 검증된 것이 아닙니다. 나머지 28개 표준은 아직 프로젝션이 없으며, 도구는 빈 목록 대신 명시적 메시지를 반환합니다.

프로젝션은 해석이지 규범이 아닙니다. 항상 조항 텍스트와 별도 필드에 위치하며, 검증되지 않은 레코드에는 별도 경고가 표시됩니다.

서버는 네트워크에 접속하지 않습니다. 시작 시에도 요청 처리 중에도 그렇습니다. 데이터베이스는 읽기 전용으로 열립니다.

하지 않는 일

• 표준 원문의 범위를 벗어난 조항에 대해 상담하거나 해석하지 않습니다.

• ITS 기사 원문을 저장하지 않습니다 — 제목과 링크만 제공합니다.

• 변호사를 대체하지 않으며, 회계 결정을 대신 내리지 않습니다.

클라이언트 연결

클라이언트는 이미 실행 중인 서버에 연결합니다 — 로컬 또는 내부 서버.

Codex

~/.codex/config.toml:

[mcp_servers.pbu_fsbu]
url = "http://127.0.0.1:18010/mcp"

Claude Code

claude mcp add --transport http pbu-fsbu http://127.0.0.1:18010/mcp

Claude Desktop

Claude Desktop은 HTTP 엔드포인트에 연결할 수 없습니다: 앱이 http:// 스킴을 거부하며, https:// 연결은 Anthropic 클라우드에서 이루어지므로 localhost에도 내부 주소에도 도달할 수 없습니다. Codex와 Claude Code는 로컬 프로세스이므로 이 문제가 없습니다.

Claude Desktop의 경우 서버는 stdio로 로컬 실행됩니다 — %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pbu-fsbu": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\pbu-fsbu-mcp", "run", "pbu-fsbu-mcp"]
    }
  }
}

uvx --from git+...로 직접 설치는 적합하지 않습니다: data/build/가 저장소에 포함되지 않으므로 코퍼스가 생성되지 않고 서버가 시작을 거부합니다. 로컬 체크아웃이 필요합니다 — «개발» 섹션 참조.

서버 배포

deploy/compose.server.yml은 내부 서버용으로 설계되었으며 로컬 네트워크에서만 접근 가능합니다:

git clone https://github.com/MihasikPro/pbu-fsbu-mcp.git
cd pbu-fsbu-mcp/deploy
docker compose -f compose.server.yml up -d --build

첫 실행 전에 파일에서 포트 게시 주소를 서버 주소로 변경하십시오. 포트는 특정 LAN 주소에 게시되며 0.0.0.0이 아닙니다: 호스트에 두 번째 인터페이스(VPN 또는 공인 IP)가 나타나면 0.0.0.0 바인딩은 서비스를 외부에 노출시킵니다.

TLS와 인증은 의도적으로 없습니다: 코퍼스는 비밀이 없는 공개 규범 텍스트입니다. 서비스를 인터넷에 노출하지 마십시오.

corpus_meta.built_at은 컨테이너 시작 시가 아닌 docker build 시점에 고정됩니다. 코퍼스 노후화 경고는 이미지 빌드 날짜로부터 90일을 계산합니다. restart와 up은 --build 없이는 코퍼스를 갱신하지 않습니다 — 재빌드가 필요합니다.

출처

• Минфин России — Федеральные стандарты бухгалтерского учёта

• publication.pravo.gov.ru — официальное опубликование правовых актов

텍스트의 기본 출처는 재무부 웹사이트의 표준 자체 페이지입니다 (https://minfin.gov.ru/ru/document?id_4=NNNN, 링크는 레지스트리에 있음): 해당 페이지의 텍스트는 스캔이나 OCR 없이 일반 서버 HTML로 제공되며, publication.pravo.gov.ru 아카이브보다 오래된 표준에도 접근 가능합니다 — 해당 아카이브는 2011년 11월경부터 시작되므로 29개 표준 중 19개를 전혀 포함하지 않습니다.

예외 — FSBU 27/2021: 재무부 웹사이트의 해당 페이지에는 텍스트가 없고 PDF 뷰어가 있는 <iframe>만 있습니다. 이 단일 표준에 대해서만 공식 명령 스캔본을 OCR(tessdata_best의 rus 모델을 사용한 Tesseract 5.x)로 인식한 후 줄 단위로 교정하여 텍스트를 얻었습니다. OCR은 문서화된 예비 경로이며 기본 방식이 아닙니다.

텍스트는 data/drafts/에서 data/sources/standards/로 파일을 이동하기 전에 공식 법령과 대조하여 검증합니다. test_html_sourced_standard_reproduces_byte_for_byte 테스트는 커밋된 HTML 스냅샷에서 코퍼스를 재생성하고 바이트 단위 일치를 요구하므로, 코퍼스는 신뢰에 기반한 것이 아니라 구조적으로 재현 가능합니다.

코퍼스에 포함되지 않는 것

표준 자체의 부록 — 자체 번호 체계를 가진 별도 부록으로 구성된 보고 양식 샘플과 상세 수치 예시 — 는 코퍼스에 포함되지 않습니다. 공식적으로는 법령의 일부이지만, 그 번호 체계(«1.», «2.» …)는 새로 시작되며 표준 조항과 충돌합니다.

조항 내부의 작업 예시와의 차이는 소스 마크업에만 있습니다: 실제 부록에는 «Положение по бухгалтерскому учету «…»»에 대한 부록이라는 자체 제목이 있습니다. PBU 18/02의 14–15항에 있는 수치 예시에는 그러한 제목이 없으며, 조항 텍스트의 일부로서 코퍼스에 완전히 포함됩니다.

라이선스

규범 법령은 저작권 객체가 아닙니다(러시아 민법 제1259조). 코드 — MIT, 데이터 조건 — data/LICENSE.

코퍼스 갱신

재무부의 새 명령이 발표되면:

1. uv run --group etl python -m etl.watch --live — 재무부 웹사이트의 레지스트리를 코퍼스와 비교하여 차이점을 표시합니다.

2. uv run --group etl python -m etl.draft_yaml --live — 조항 텍스트를 추출하여 초안을 data/drafts/에 저장합니다.

3. 공식 명령과 대조하여 텍스트를 교정하고 data/sources/standards/로 이동한 후 # ЧЕРНОВИК 배너를 제거합니다.

4. uv run python -m etl.build_db && uv run python -m etl.validate

5. uv run --group etl pytest

동일한 비교는 etl-watch 워크플로우가 매주 수행하며, 차이점이 발견되면 보고서와 함께 pull request를 엽니다. 자동 병합은 없습니다: 새 명령은 사람이 읽습니다.

1C 연결 및 ITS 링크 추가 규칙 — CONTRIBUTING.md 참조.

개발

uv sync --all-groups
uv run python -m etl.build_db
uv run python -m etl.validate
uv run --group etl pytest

진실의 원천은 data/sources/의 YAML입니다. data/build/pbu_fsbu.db 파일은 이들로부터 빌드되며 저장소에 커밋되지 않습니다.

서버는 컨테이너 없이도 실행할 수 있습니다:

uv run pbu-fsbu-mcp                                    # stdio
uv run pbu-fsbu-mcp --transport http --port 18010      # HTTP

OCR 테스트 및 Tesseract

인식 테스트(tests/test_ocr_text.py)는 로컬에 설치된 Tesseract 5.x와 rus 모델이 필요합니다. 없으면 건너뜁니다 — 나머지 테스트 세트는 이와 무관합니다. 실제로 실행하려면:

• TESSERACT_CMD — PATH에 바이너리가 없는 경우 tesseract 경로;

• TESSDATA_PREFIX — 표준 위치가 아닌 경우 *.traineddata 모델 디렉터리.

$env:TESSERACT_CMD = "C:\Program Files\Tesseract-OCR\tesseract.exe"
$env:TESSDATA_PREFIX = "C:\Users\<user>\.tessdata"
uv run --group etl pytest

CI에서는 Tesseract와 rus 모델이 apt-get으로 설치됩니다 — .github/workflows/ci.yml 참조.