Bay Street MCP

Claude(및 모든 MCP 클라이언트)가 OSFI, PIPEDA, FINTRAC, 퀘벡 법 25호와 같은 실제 캐나다 금융 서비스 규정을 인용할 수 있도록 하는 Model Context Protocol 서버입니다.

AI가 캐나다 핀테크 규정 준수 답변을 환각(hallucination)하지 않도록 방지하세요.

상태

🚧 초기 개발 단계. 프로젝트 스캐폴딩 및 v0.1 로드맵이 초기 커밋에 포함되었습니다. 첫 번째 작동 릴리스(v0.1.0)는 약 6주 후를 목표로 점진적으로 구축 중입니다. 커밋 기록에서 주간 진행 상황을 확인하세요.

캐나다 핀테크 AI 도구에 이 기능이 필요하다면 저장소를 Watch하거나 Star를 눌러주세요. 로드맵에 대한 실질적인 피드백은 Issues를 통해 환영합니다.

데모

데모는 v0.1.0 릴리스와 함께 제공됩니다: Claude Desktop이 compliance_lookup을 호출하고 규정 질문에 대해 원본 문서를 인용하여 답변하는 90초 분량의 화면 녹화 영상입니다.

제작 동기

저는 20년 동안 캐나다 금융 서비스(TD, Canada Life, Gore Mutual) 분야에 종사했습니다. AI 기능을 출시하는 모든 캐나다 핀테크 기업들이 같은 벽에 부딪히는 것을 보았습니다. 학습 데이터에 캐나다 규정보다 미국/EU 규정이 100배 더 많기 때문에, LLM이 OSFI E-21 위험 관리나 PIPEDA 공개 의무에 대해 자신 있게 잘못된 답변을 내놓는 것입니다.

이 MCP 서버가 그 문제를 해결합니다. Claude를 이 서버에 연결하고 캐나다 금융 규정에 대해 질문하면, 실제 문서에 근거한 답변과 인용문을 얻을 수 있습니다.

빠른 시작 (v0.1 계획, 현재 미작동)

아래 지침은 v0.1.0 출시 후 서버가 작동하는 방식을 설명합니다. 현재 커밋에서는 작동하지 않습니다. 진행 상황은 위의 상태 표에서 추적할 수 있습니다.

1. 복제 및 설치:

   git clone https://github.com/ziamalik/bay-street-mcp.git
   cd bay-street-mcp
   uv sync

2. 규정 PDF를 다운로드합니다. v0.1 예시의 경우, https://www.osfi-bsif.gc.ca/에서 OSFI 가이드라인 E-21(운영 위험 관리 및 복원력)을 가져오세요.

3. 수집:

   uv run bay-street-ingest data/osfi-e21.pdf \
     --regulation "OSFI Guideline E-21" \
     --jurisdiction CA \
     --source-url "https://www.osfi-bsif.gc.ca/en/guidance/guidance-library/operational-risk-management-resilience"

4. claude_desktop_config.json에 추가합니다(macOS의 경우 보통 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows의 경우 %APPDATA%\Claude\claude_desktop_config.json에 위치):

   {
     "mcpServers": {
       "bay-street": {
         "command": "uv",
         "args": ["--directory", "/absolute/path/to/bay-street-mcp", "run", "bay-street-mcp"]
       }
     }
   }

   패키지를 전역으로 설치한 경우 대체 호출 방법은 claude_desktop_config.example.json을 참조하세요.

5. Claude Desktop을 재시작합니다. 다음을 질문하세요:

   OSFI E-21은 AI 위험 관리에 대해 무엇이라고 말하나요?

   Claude가 compliance_lookup을 호출하고 인용문과 함께 답변할 것입니다.

v0.1 제공 예정 기능 (출시 시)

• MCP 도구 1개: {regulation, jurisdiction, page, source_url} 인용 메타데이터와 함께 구절을 반환하는 compliance_lookup(query, top_k)

• 기본 제공 규정 1개: OSFI 가이드라인 E-21 (PDF 직접 로드)

• Chroma 벡터 저장소, 디스크에 영구 저장

• Stdio 전송 (Claude Desktop, Claude Code, Cursor, 모든 MCP 클라이언트와 호환)

• 약 400줄의 Python 코드

이후 버전에서는 PIPEDA, FINTRAC, 퀘벡 법 25호를 추가하고, OSFI E-23(모델 위험) 및 B-13(기술 및 사이버 위험)으로 확장할 예정입니다. 아래 로드맵을 참조하세요.

로드맵

v0.1 (진행 중, 예상 소요 시간 ~6주):

• [x] 프로젝트 스캐폴딩, CI, 라이선스, 종속성, MCP 서버 스텁

• [ ] OSFI 가이드라인 E-21 엔드투엔드 수집 기능

• [ ] compliance_lookup MCP 도구, 실제 인용 구절 반환

• [ ] 엔드투엔드 Claude Desktop 데모 (Loom)

• [ ] 첫 공개 릴리스(v0.1.0 태그)

v0.2 및 이후:

• [ ] PIPEDA 전문 + 요약

• [ ] FINTRAC AML/ATF 지침

• [ ] 퀘벡 법 25호

• [ ] OSFI E-23 (모델 위험 관리)

• [ ] OSFI B-13 (기술 및 사이버 위험)

• [ ] 규제 기관 사이트에서 차이점 감지를 통한 자동 새로고침

• [ ] 전체 문서 검색을 위한 리소스 엔드포인트

• [ ] 인용 형식 지정 (APA, 일반 텍스트)

• [ ] 사전 빌드된 Docker 이미지

작동 원리

User question  →  Claude  →  MCP tool call  →  Chroma similarity search
       →  top-k passages with metadata  →  Claude synthesizes answer with citations

수집 스크립트는 각 규정을 약 800단어 단위(100단어 중첩)로 청크 처리하여 {regulation, jurisdiction, page, source_url} 메타데이터와 함께 Chroma에 저장합니다. MCP 도구는 전체 인용 메타데이터가 포함된 구절을 반환하므로, Claude는 응답 시 페이지 번호와 소스 URL을 인용할 수 있습니다.

MCP를 사용하는 이유

MCP(Model Context Protocol)는 LLM을 외부 컨텍스트에 연결하기 위한 표준 인터페이스로 자리 잡고 있습니다. 이를 MCP 서버로 노출하면 매번 맞춤형 통합을 구축할 필요 없이 Claude Desktop, Claude Code, Cursor 및 향후 모든 MCP 클라이언트에서 동일한 규정 준수 지식을 사용할 수 있습니다.

개발

uv sync --all-extras
uv run pytest
uv run ruff check .

라이선스

MIT. 자유롭게 사용하고, 포크하고, 배포하세요.

정보

Zia Malik 제작 — 20년 경력의 캐나다 금융 서비스 전문가, 현재 AppVet(AI 기반 웹 앱 보안 감사)을 구축 중이며 핀테크급 AI 엔지니어링에 관한 글을 쓰고 있습니다.

캐나다 핀테크 기업에 종사하며 특정 규제 영역에 대해 이 기능을 확장하고 싶다면, 이슈를 열거나 연락해 주세요.