🇨🇮 BRVM MCP Server

Первый MCP-сервер для региональной фондовой биржи Западной Африки.

Подключите любого ИИ-агента — Claude, ChatGPT, Cursor, Copilot, LangGraph — к актуальным рыночным данным BRVM (Bourse Régionale des Valeurs Mobilières), обслуживающей 8 государств-членов UEMOA в Западной Африке.

Зачем это нужно?

На бирже BRVM котируются около 46 компаний из Бенина, Буркина-Фасо, Кот-д'Ивуара, Гвинеи-Бисау, Мали, Нигера, Сенегала и Того с общей рыночной капитализацией около 27,8 млрд долларов США. Однако у нее нет публичного API. Этот сервер устраняет данный пробел, делая данные BRVM доступными для экосистемы ИИ через Model Context Protocol.

Что ожидает BRVM в будущем

• 18 декабря 2026 г.: Первый рынок деривативов во франкоязычной Западной Африке (фьючерсы на индексы и акции)

• 2026–2027 гг.: Листинг ETF

• 2026 г.: Биржа сельскохозяйственных товаров (BMPA CI) — кешью, кукуруза, орехи кола

Этот сервер создан для развития вместе с данными изменениями.

Related MCP server: Yahoo Finance MCP Server

Функции

Инструменты (7)

Ресурсы

Промпты

Быстрый старт

Предварительные требования

• Python 3.11+

• uv (рекомендуется) или pip

Установка и запуск

# Clone
git clone https://github.com/dilanefk/brvm-mcp-server.git
cd brvm-mcp-server

# Install
uv sync

# Run (stdio — for Claude Desktop / Cursor)
uv run brvm-mcp

# Run (HTTP — for remote agents / web apps)
uv run brvm-mcp --transport streamable-http --port 8000

Подключение к Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "brvm": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/brvm-mcp-server", "brvm-mcp"]
    }
  }
}

Перезапустите Claude Desktop. Вы увидите инструменты BRVM в меню 🔨.

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector uv run brvm-mcp

Docker (удаленное развертывание)

docker build -t brvm-mcp .
docker run -p 8000:8000 brvm-mcp

Примеры диалогов

После подключения вы можете спросить Claude:

"Что происходит на рынке BRVM сегодня?" → Вызывает get_market_summary(), возвращает полные данные сессии

"Покажи мне цену акций Sonatel" → Вызывает get_stock_price("SNTS")

"Какие акции BRVM из Сенегала?" → Вызывает search_stocks(country="Сенегал")

"Составь полный отчет по рынку" → Использует промпт market_report для организации нескольких вызовов инструментов

"Какие акции упали больше всего сегодня?" → Вызывает get_top_movers(), фокусируясь на лидерах падения

Архитектура

┌──────────────────┐     MCP (stdio/HTTP)     ┌──────────────────┐
│   AI Agent       │◄────────────────────────►│  BRVM MCP Server │
│ (Claude, GPT,    │                          │                  │
│  Cursor, etc.)   │                          │  FastMCP + Tools │
└──────────────────┘                          │  + Cache Layer   │
                                              └────────┬─────────┘
                                                       │ httpx
                                              ┌────────▼─────────┐
                                              │  Data Sources    │
                                              │  • afx.kwayisi   │
                                              │  • brvm.org      │
                                              │  • Rich Bourse   │
                                              └──────────────────┘

• FastMCP: Фреймворк MCP на основе декораторов (официальный SDK для Python)

• httpx: Асинхронный HTTP-клиент для парсинга

• BeautifulSoup4 + lxml: Парсинг HTML

• diskcache: Дисковое кэширование с TTL (по умолчанию 5 минут, с уважением к источникам)

• Pydantic: Структурированные модели данных

Дорожная карта

• [ ] v0.2 — Исторические данные о ценах (бары OHLCV)

• [ ] v0.3 — Официальные объявления BRVM / лента корпоративных действий

• [ ] v0.4 — Данные по товарам BMPA CI (по мере доступности)

• [ ] v0.5 — Данные по деривативам (фьючерсы, опционы — после запуска в декабре 2026 г.)

• [ ] v1.0 — OAuth + ограничение частоты запросов для многопользовательского развертывания

• [ ] Регистрация в реестре MCP

Источники данных и добросовестное использование

Этот сервер собирает общедоступные данные. Он реализует:

• Кэширование (TTL 5 минут) для минимизации запросов

• Вежливый заголовок User-Agent, идентифицирующий проект

• Отсутствие обхода аутентификации — только публичные данные

Для получения потоков FIX в реальном времени свяжитесь с BRVM напрямую: brvm.org/real-time-data-feed

Участие в разработке

Приветствуются PR! Приоритетные области:

1. Дополнительные источники данных (eodhd.com, Rich Bourse)

2. Поддержка исторических данных

3. Тесты (pytest + VCR cassettes для тестов парсера)

4. Портирование на TypeScript для хостов MCP на Node.js

Лицензия

MIT

Создано с ☕ на Маврикии Диланом Фоге Камга — старшим инженером по программному обеспечению и ИИ, магистром финансовой инженерии (WorldQuant University).

Соединяя ИИ и африканские рынки капитала.