🇨🇮 BRVM MCP 서버

서아프리카 지역 증권 거래소를 위한 최초의 MCP 서버.

Claude, ChatGPT, Cursor, Copilot, LangGraph 등 모든 AI 에이전트를 서아프리카 8개 UEMOA 회원국을 관할하는 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 설정 파일(~/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 프레임워크 (공식 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

기여

PR을 환영합니다! 우선순위 분야:

1. 추가 데이터 소스 (eodhd.com, Rich Bourse)

2. 과거 데이터 지원

3. 테스트 (스크래퍼 테스트를 위한 pytest + VCR cassettes)

4. Node.js MCP 호스트를 위한 TypeScript 포팅

라이선스

MIT

모리셔스에서 ☕와 함께 제작됨. 제작자: Dilane Fogué Kamga — 수석 소프트웨어 및 AI 엔지니어, 금융 공학 석사 (WorldQuant University).

AI와 아프리카 자본 시장을 연결합니다.