🇨🇮 BRVM MCP-Server

Der erste MCP-Server für die Regionalbörse Westafrikas.

Verbinden Sie jeden KI-Agenten — Claude, ChatGPT, Cursor, Copilot, LangGraph — mit Live-Marktdaten der BRVM (Bourse Régionale des Valeurs Mobilières), die 8 UEMOA-Mitgliedsstaaten in Westafrika bedient.

Warum?

Die BRVM listet ca. 46 Unternehmen in Benin, Burkina Faso, Côte d'Ivoire, Guinea-Bissau, Mali, Niger, Senegal und Togo — mit einer kombinierten Marktkapitalisierung von ca. 27,8 Mrd. USD. Dennoch gibt es keine öffentliche API. Dieser Server schließt diese Lücke und macht BRVM-Daten für das KI-Ökosystem über das Model Context Protocol zugänglich.

Was kommt auf die BRVM zu

• 18. Dezember 2026: Erster Derivatemarkt im frankophonen Westafrika (Futures auf Indizes und Aktien)

• 2026–2027: ETF-Listings

• 2026: Landwirtschaftliche Warenbörse (BMPA CI) — Cashew, Mais, Kolanuss

Dieser Server ist so konzipiert, dass er mit diesen Entwicklungen wächst.

Related MCP server: Yahoo Finance MCP Server

Funktionen

Tools (7)

Ressourcen

Prompts

Schnellstart

Voraussetzungen

• Python 3.11+

• uv (empfohlen) oder pip

Installation & Ausführung

# 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

Verbindung mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

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

Starten Sie Claude Desktop neu. Sie werden die BRVM-Tools im 🔨-Menü sehen.

Test mit MCP Inspector

npx @modelcontextprotocol/inspector uv run brvm-mcp

Docker (Remote-Bereitstellung)

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

Beispielkonversationen

Sobald die Verbindung hergestellt ist, können Sie Claude fragen:

"Wie läuft der BRVM-Markt heute?" → Ruft get_market_summary() auf, liefert vollständige Sitzungsdaten

"Zeig mir den Aktienkurs von Sonatel" → Ruft get_stock_price("SNTS") auf

"Welche BRVM-Aktien kommen aus dem Senegal?" → Ruft search_stocks(country="Sénégal") auf

"Gib mir einen vollständigen Marktbericht" → Verwendet den market_report-Prompt, um mehrere Tool-Aufrufe zu koordinieren

"Welche Aktien sind heute am stärksten gefallen?" → Ruft get_top_movers() auf, fokussiert auf Verlierer

Architektur

┌──────────────────┐     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: Dekorator-basiertes MCP-Framework (offizielles Python SDK)

• httpx: Asynchroner HTTP-Client für das Scraping

• BeautifulSoup4 + lxml: HTML-Parsing

• diskcache: TTL-basiertes Disk-Caching (5 Min. Standard, respektiert die Quellen)

• Pydantic: Strukturierte Datenmodelle

Roadmap

• [ ] v0.2 — Historische Preisdaten (OHLCV-Balken)

• [ ] v0.3 — Offizielle BRVM-Ankündigungen / Feed zu Unternehmensmaßnahmen

• [ ] v0.4 — BMPA CI Warenmarktdaten (sobald verfügbar)

• [ ] v0.5 — Derivatdaten (Futures, Optionen — nach dem Start im Dez. 2026)

• [ ] v1.0 — OAuth + Ratenbegrenzung für Multi-User-Bereitstellungen

• [ ] Registrierung im MCP Registry

Datenquellen & Fair Use

Dieser Server scrapt öffentlich verfügbare Daten. Er implementiert:

• Caching (5 Min. TTL), um Anfragen zu minimieren

• Höflichen User-Agent-Header, der das Projekt identifiziert

• Keine Umgehung der Authentifizierung — nur öffentliche Daten

Für Echtzeit-FIX-Feeds kontaktieren Sie die BRVM direkt: brvm.org/real-time-data-feed

Mitwirken

PRs sind willkommen! Prioritätsbereiche:

1. Zusätzliche Datenquellen (eodhd.com, Rich Bourse)

2. Unterstützung für historische Daten

3. Tests (pytest + VCR-Kassetten für Scraper-Tests)

4. TypeScript-Port für Node.js MCP-Hosts

Lizenz

MIT

Mit ☕ auf Mauritius entwickelt von Dilane Fogué Kamga — Senior Software & AI Engineer, Financial Engineering MSc (WorldQuant University).

Brückenschlag zwischen KI und afrikanischen Kapitalmärkten.