🇨🇮 Servidor MCP de la BRVM

El primer servidor MCP para la bolsa de valores regional de África Occidental.

Conecte cualquier agente de IA — Claude, ChatGPT, Cursor, Copilot, LangGraph — a datos de mercado en tiempo real de la BRVM (Bourse Régionale des Valeurs Mobilières), que presta servicio a 8 estados miembros de la UEMOA en África Occidental.

¿Por qué?

La BRVM cotiza unas 46 empresas en Benín, Burkina Faso, Costa de Marfil, Guinea-Bisáu, Malí, Níger, Senegal y Togo, con una capitalización de mercado combinada de unos 27.800 millones de dólares estadounidenses. Sin embargo, no tiene una API pública. Este servidor cierra esa brecha, haciendo que los datos de la BRVM sean accesibles para el ecosistema de IA a través del Protocolo de Contexto de Modelo.

¿Qué se avecina en la BRVM?

• 18 de diciembre de 2026: Primer mercado de derivados en el África occidental francófona (futuros sobre índices y acciones)

• 2026–2027: Listados de ETF

• 2026: Bolsa de productos agrícolas (BMPA CI) — anacardo, maíz, nuez de cola

Este servidor está diseñado para crecer junto con estos desarrollos.

Related MCP server: Yahoo Finance MCP Server

Características

Herramientas (7)

Recursos

Prompts

Inicio rápido

Requisitos previos

• Python 3.11+

• uv (recomendado) o pip

Instalación y ejecución

# 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

Conexión a Claude Desktop

Agréguelo a su configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Reinicie Claude Desktop. Verá las herramientas de la BRVM en el menú 🔨.

Prueba con el Inspector MCP

npx @modelcontextprotocol/inspector uv run brvm-mcp

Docker (despliegue remoto)

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

Ejemplos de conversaciones

Una vez conectado, puede preguntarle a Claude:

"¿Qué está haciendo el mercado de la BRVM hoy?" → Llama a get_market_summary(), devuelve los datos completos de la sesión

"Muéstrame el precio de las acciones de Sonatel" → Llama a get_stock_price("SNTS")

"¿Qué acciones de la BRVM son de Senegal?" → Llama a search_stocks(country="Sénégal")

"Dame un informe de mercado completo" → Utiliza el prompt market_report para orquestar múltiples llamadas a herramientas

"¿Qué acciones cayeron más hoy?" → Llama a get_top_movers(), se centra en los perdedores

Arquitectura

┌──────────────────┐     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: Marco de trabajo MCP basado en decoradores (SDK oficial de Python)

• httpx: Cliente HTTP asíncrono para scraping

• BeautifulSoup4 + lxml: Análisis de HTML

• diskcache: Caché de disco basada en TTL (5 min por defecto, respetuoso con las fuentes)

• Pydantic: Modelos de datos estructurados

Hoja de ruta

• [ ] v0.2 — Datos históricos de precios (barras OHLCV)

• [ ] v0.3 — Feed de anuncios oficiales de la BRVM / acciones corporativas

• [ ] v0.4 — Datos de productos básicos de BMPA CI (cuando estén disponibles)

• [ ] v0.5 — Datos de derivados (futuros, opciones — tras el lanzamiento de diciembre de 2026)

• [ ] v1.0 — OAuth + limitación de tasa para despliegue multiusuario

• [ ] Registrarse en el Registro MCP

Fuentes de datos y uso justo

Este servidor extrae datos disponibles públicamente. Implementa:

• Caché (TTL de 5 min) para minimizar las solicitudes

• Cabecera User-Agent educada que identifica el proyecto

• Sin omisión de autenticación — solo datos públicos

Para feeds FIX en tiempo real, contacte directamente con la BRVM: brvm.org/real-time-data-feed

Contribución

¡Las PR son bienvenidas! Áreas prioritarias:

1. Fuentes de datos adicionales (eodhd.com, Rich Bourse)

2. Soporte de datos históricos

3. Pruebas (pytest + casetes VCR para pruebas de scraper)

4. Puerto TypeScript para hosts MCP de Node.js

Licencia

MIT

Construido con ☕ en Mauricio por Dilane Fogué Kamga — Ingeniero Senior de Software e IA, Máster en Ingeniería Financiera (WorldQuant University).

Uniendo la IA y los mercados de capitales africanos.