Bay Street MCP

Сервер протокола контекста модели (MCP), который позволяет Claude (и любому клиенту MCP) ссылаться на актуальные канадские правила финансовых услуг: OSFI, PIPEDA, FINTRAC, Закон Квебека 25.

Предотвратите галлюцинации вашего ИИ при ответах на вопросы о соответствии требованиям для канадского финтеха.

Статус

🚧 Ранняя стадия разработки. Каркас проекта и дорожная карта v0.1 были добавлены в первом коммите. Первый рабочий релиз (v0.1.0) запланирован примерно через 6 недель и будет создаваться постепенно. Следите за историей коммитов, чтобы видеть еженедельный прогресс.

Если вам это нужно для вашего инструментария канадского финтех-ИИ, подпишитесь на репозиторий или поставьте звезду. Существенные отзывы по дорожной карте приветствуются через Issues.

Демонстрация

Демонстрация появится с релизом v0.1.0: 90-секундная запись экрана, показывающая, как Claude Desktop вызывает compliance_lookup и отвечает на регуляторный вопрос со ссылкой на исходный документ.

Почему я это создал

Я провел 20 лет в сфере канадских финансовых услуг (TD, Canada Life, Gore Mutual). Каждый канадский финтех, с которым я общался и который внедряет функции ИИ, сталкивается с одной и той же проблемой: их LLM уверенно выдумывает ответы о риск-менеджменте по OSFI E-21 или обязательствах по раскрытию информации по PIPEDA, потому что в обучающих данных в 100 раз больше регулирующих норм США/ЕС, чем канадских.

Этот сервер 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 возьмите руководство OSFI E-21 (Operational Risk Management and Resilience) с сайта https://www.osfi-bsif.gc.ca/.

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 (обычно находится по адресу ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows):

   {
     "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 об управлении рисками ИИ?

   Claude вызовет compliance_lookup и ответит с цитатами.

Что даст v0.1 (после выпуска)

• Один инструмент MCP: compliance_lookup(query, top_k), возвращающий отрывки с метаданными цитирования {regulation, jurisdiction, page, source_url}

• Одно правило, поддерживаемое «из коробки»: руководство 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 (сквозная)

• [ ] Инструмент MCP compliance_lookup, возвращающий реальные цитируемые отрывки

• [ ] Сквозная демонстрация 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 слов и сохраняет их в Chroma с метаданными {regulation, jurisdiction, page, source_url}. Инструмент 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. Используйте, форкайте, выпускайте.

Об авторе

Создано Зиа Маликом — 20 лет в сфере канадских финансовых услуг, в настоящее время создает AppVet (аудит безопасности веб-приложений на базе ИИ) и пишет о финтех-инженерии с использованием ИИ.

Если вы работаете в канадском финтехе и хотите, чтобы это было расширено для вашей конкретной регуляторной области, откройте issue или свяжитесь со мной.