🇨🇮 BRVM MCP 服务器

西非区域证券交易所的首个 MCP 服务器。

将任何 AI 智能体（Claude、ChatGPT、Cursor、Copilot、LangGraph）连接到来自 BRVM（西非区域证券交易所）的实时市场数据，该交易所服务于西非 8 个 UEMOA 成员国。

为什么选择它？

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 K 线)

• [ ] v0.3 — BRVM 官方公告 / 公司行动推送

• [ ] v0.4 — BMPA CI 商品数据（可用时）

• [ ] v0.5 — 衍生品数据（期货、期权 — 2026 年 12 月推出后）

• [ ] v1.0 — 用于多用户部署的 OAuth + 速率限制

• [ ] 在 MCP 注册表 上注册

数据来源与合理使用

此服务器抓取公开可用的数据。它实现了：

• 缓存（5 分钟 TTL）以最小化请求

• 礼貌的 User-Agent 标头以标识项目

• 无身份验证绕过 — 仅限公开数据

如需实时 FIX 数据源，请直接联系 BRVM：brvm.org/real-time-data-feed

贡献

欢迎提交 PR！优先领域：

1. 额外的数据源 (eodhd.com, Rich Bourse)

2. 历史数据支持

3. 测试 (pytest + 用于抓取测试的 VCR cassettes)

4. 用于 Node.js MCP 主机的 TypeScript 移植

许可证

MIT

由 Dilane Fogué Kamga 在毛里求斯伴着 ☕ 构建 — 高级软件与 AI 工程师，金融工程硕士 (WorldQuant University)。

架起 AI 与非洲资本市场的桥梁。