Bay Street MCP

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite a Claude (y a cualquier cliente MCP) citar regulaciones reales de servicios financieros canadienses: OSFI, PIPEDA, FINTRAC, Ley 25 de Quebec.

Evita que tu IA alucine respuestas de cumplimiento para fintechs canadienses.

Estado

🚧 Desarrollo inicial. El andamiaje del proyecto y la hoja de ruta de la v0.1 se incluyeron en el commit inicial. La primera versión funcional (v0.1.0) está prevista para dentro de unas 6 semanas, construida de forma incremental. Sigue el historial de commits para ver el progreso semanal.

Si deseas esto para tus herramientas de IA de fintech canadiense, sigue o marca el repositorio como favorito. Los comentarios sustanciales sobre la hoja de ruta son bienvenidos a través de Issues.

Demostración

La demostración llegará con el lanzamiento de la v0.1.0: una grabación de pantalla de 90 segundos que muestra a Claude Desktop llamando a compliance_lookup y respondiendo a una pregunta regulatoria con una cita que remite al documento fuente.

Por qué construí esto

He pasado 20 años en servicios financieros canadienses (TD, Canada Life, Gore Mutual). Cada fintech canadiense con la que he hablado que está lanzando funciones de IA se topa con el mismo muro: su LLM inventa respuestas con confianza sobre la gestión de riesgos de la OSFI E-21 o las obligaciones de divulgación de PIPEDA porque los datos de entrenamiento tienen 100 veces más regulación de EE. UU./UE que de Canadá.

Este servidor MCP soluciona eso. Apunta a Claude hacia él, haz cualquier pregunta sobre la regulación financiera canadiense y obtén una respuesta fundamentada en el documento real con citas.

Inicio rápido (planificado para la v0.1, aún no funcional)

Las instrucciones a continuación describen cómo funcionará el servidor una vez que se lance la v0.1.0. No funcionan con el commit actual. El seguimiento del progreso se encuentra en la tabla de Estado anterior.

1. Clona e instala:

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

2. Descarga un PDF de regulación. Para el ejemplo de la v0.1, obtén la Directriz E-21 de OSFI (Gestión de Riesgos Operativos y Resiliencia) desde https://www.osfi-bsif.gc.ca/.

3. Ingiérelo:

   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. Agrégalo a tu claude_desktop_config.json (normalmente en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows):

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

   Consulta claude_desktop_config.example.json para una invocación alternativa si has instalado el paquete globalmente.

5. Reinicia Claude Desktop. Pregunta:

   ¿Qué dice la OSFI E-21 sobre la gestión de riesgos de IA?

   Claude llamará a compliance_lookup y responderá con citas.

Qué entregará la v0.1 (cuando se lance)

• Una herramienta MCP: compliance_lookup(query, top_k) que devuelve pasajes con metadatos de cita {regulation, jurisdiction, page, source_url}

• Una regulación soportada de forma nativa: Directriz E-21 de OSFI (tú cargas el PDF)

• Almacén vectorial Chroma, persistente en disco

• Transporte Stdio (funciona con Claude Desktop, Claude Code, Cursor, cualquier cliente MCP)

• Alrededor de 400 líneas de Python

Las versiones posteriores añadirán PIPEDA, FINTRAC, la Ley 25 de Quebec, y luego se expandirán a OSFI E-23 (riesgo de modelo) y B-13 (riesgo tecnológico y cibernético). Consulta la Hoja de ruta a continuación.

Hoja de ruta

v0.1 (en progreso, ETA ~6 semanas):

• [x] Andamiaje del proyecto, CI, licencia, dependencias, stub del servidor MCP

• [ ] Ingesta de la Directriz E-21 de OSFI funcionando de extremo a extremo

• [ ] Herramienta MCP compliance_lookup devolviendo pasajes citados reales

• [ ] Demostración de extremo a extremo en Claude Desktop (Loom)

• [ ] Primer lanzamiento público (etiqueta v0.1.0)

v0.2 y posteriores:

• [ ] Texto completo + resumen de PIPEDA

• [ ] Guía AML/ATF de FINTRAC

• [ ] Ley 25 de Quebec

• [ ] OSFI E-23 (gestión de riesgos de modelo)

• [ ] OSFI B-13 (riesgo tecnológico y cibernético)

• [ ] Actualización automática desde sitios de reguladores con detección de diferencias

• [ ] Puntos finales de recursos para la recuperación de documentos completos

• [ ] Formato de citas (APA, texto plano)

• [ ] Imagen Docker preconstruida

Cómo funciona

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

El script de ingesta divide cada regulación en fragmentos de ~800 palabras con una superposición de 100 palabras, y los almacena en Chroma con metadatos {regulation, jurisdiction, page, source_url}. La herramienta MCP devuelve pasajes con metadatos de cita completos, por lo que Claude puede citar números de página y URLs de origen en su respuesta.

Por qué MCP

MCP (Protocolo de Contexto de Modelo) se está convirtiendo en la interfaz estándar para conectar LLMs a contextos externos. Exponer esto como un servidor MCP significa que el mismo conocimiento de cumplimiento es utilizable desde Claude Desktop, Claude Code, Cursor y cualquier cliente MCP futuro sin tener que construir una integración personalizada cada vez.

Desarrollo

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

Licencia

MIT. Úsala, haz un fork, publícala.

Acerca de

Creado por Zia Malik — 20 años en servicios financieros canadienses, actualmente construyendo AppVet (auditorías de seguridad de aplicaciones web impulsadas por IA) y escribiendo sobre ingeniería de IA de grado fintech.

Si trabajas en una fintech canadiense y quieres que esto se extienda para tu área regulatoria específica, abre un issue o contáctame.