🇨🇮 BRVM MCPサーバー

西アフリカ地域証券取引所向けの初のMCPサーバー。

Claude、ChatGPT、Cursor、Copilot、LangGraphなどのあらゆるAIエージェントを、西アフリカのUEMOA加盟8カ国にサービスを提供するBRVM（Bourse Régionale des Valeurs Mobilières：地域証券取引所）のライブ市場データに接続します。

なぜこれが必要なのか？

BRVMは、ベナン、ブルキナファソ、コートジボワール、ギニアビサウ、マリ、ニジェール、セネガル、トーゴの約46社を上場しており、合計時価総額は約278億米ドルに達します。しかし、公開APIが存在しません。このサーバーはそのギャップを埋め、Model Context Protocolを通じてAIエコシステムがBRVMデータにアクセスできるようにします。

BRVMの今後の予定

• 2026年12月18日: フランス語圏西アフリカ初のデリバティブ市場（指数および株式の先物）

• 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の設定（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "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="Sénégal")を呼び出します

"市場レポートを詳しく作成して" → 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フレームワーク（公式Python SDK）

• httpx: スクレイピング用の非同期HTTPクライアント

• BeautifulSoup4 + lxml: HTML解析

• diskcache: TTLベースのディスクキャッシュ（デフォルト5分、ソースに配慮）

• Pydantic: 構造化データモデル

ロードマップ

• [ ] v0.2 — 過去の価格データ（OHLCVバー）

• [ ] v0.3 — BRVM公式発表 / コーポレートアクションフィード

• [ ] v0.4 — BMPA CI商品データ（利用可能になり次第）

• [ ] v0.5 — デリバティブデータ（先物、オプション — 2026年12月以降）

• [ ] v1.0 — マルチユーザーデプロイ用のOAuth + レート制限

• [ ] MCP Registryへの登録

データソースとフェアユース

このサーバーは公開されているデータをスクレイピングします。以下を実装しています：

• キャッシュ（5分のTTL）によるリクエストの最小化

• プロジェクトを識別する丁寧なUser-Agentヘッダー

• 認証バイパスなし — 公開データのみ

リアルタイムのFIXフィードについては、BRVMに直接お問い合わせください：brvm.org/real-time-data-feed

貢献

プルリクエストを歓迎します！優先分野：

1. 追加のデータソース（eodhd.com、Rich Bourse）

2. 過去データサポート

3. テスト（pytest + スクレイパーテスト用のVCRカセット）

4. Node.js MCPホスト向けのTypeScript移植

ライセンス

MIT

モーリシャスにて☕で構築。開発者：Dilane Fogué Kamga — シニアソフトウェア＆AIエンジニア、金融工学修士（WorldQuant University）。

AIとアフリカの資本市場を繋ぐ。