재무 MCP 서버
고급 재무 분석, 주식 모니터링 및 실시간 시장 정보를 위한 맞춤형 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 포트폴리오 관리, 시장 요약, 주식 알림 및 상황별 재무 인사이트를 위한 다양한 도구와 API 엔드포인트를 제공하며, Claude Desktop 및 기타 MCP 호환 클라이언트와 원활하게 통합되도록 설계되었습니다.
주요 특징
- 실시간 주가 모니터링 : 사용자가 정의한 주식 및 임계값에 대한 가격 변동을 추적하고 알림을 보냅니다.
- 포트폴리오 관리 : 지속적인 포트폴리오에서 추적된 주식을 추가, 제거 및 확인합니다.
- 시장 요약 : 지수, 주요 상승/하락 종목, 뉴스 헤드라인을 포함한 글로벌 시장 데이터를 실시간으로 검색합니다.
- 상황에 맞는 재무 통찰력 : 사용자 쿼리를 분석하고, 재무 개체를 추출하고, 관련 뉴스를 가져와 요약하고, 실행 가능한 메시지를 생성합니다.
- 자동 알림 : 가격 임계값, 거래 기회, 시스템 오류에 대한 Telegram 알림을 받습니다.
- 사용자 정의 가능한 구성 : 유연한 알림을 위한 JSON 기반 섹터 및 주식 구성.
- 강력한 로깅 및 오류 처리 : 투명성과 문제 해결을 위한 자세한 로그 및 오류 메시지.
시스템 개요
핵심 엔드포인트 및 도구
- financial_context(쿼리: str)
- 사용자 쿼리에서 티커와 키워드를 추출하고, 관련 뉴스를 가져와 요약하며, 다운스트림 분석을 위한 구조화된 컨텍스트와 프롬프트를 반환합니다.
- 시장 요약()
- 지수, 주요 변동 종목, 뉴스 헤드라인을 포함한 글로벌 시장의 실시간 요약을 제공합니다.
- get_portfolio()
- 사용자 포트폴리오에서 추적 중인 주식의 현재 목록을 검색합니다.
- add_stock(티커: 문자열) / remove_stock(티커: 문자열)
- 캐시 무효화 및 검증을 통해 포트폴리오에 주식을 추가하거나 제거합니다.
- 포트폴리오_알림(무작위_문자열: 문자열)
- 포트폴리오에 대해 트리거된 모든 알림을 반환하거나, 제공된 경우 특정 티커에 대한 알림을 반환합니다.
- check_stock_alerts(티커: 문자열) / single_stock_alert(티커: 문자열)
- 특정 주식에 대한 알림을 반환하고 자세한 오류 처리를 제공합니다.
자동 알림
- Telegram 통합 : 구성된 Telegram 채팅에 형식화된 알림과 요약을 보냅니다.
- 거래 기회 : 실행 가능한 거래 신호를 감지하고 알립니다.
문맥적 요약
- 뉴스 요약기 : 로컬 LLM(Ollama/Mistral)을 사용하여 금융 뉴스 기사에 대한 상세하고 감정 태그가 달린 요약을 생성합니다.
- 프롬프트 빌더 : 다운스트림 LLM이나 보조원에서 사용할 시장 인식 프롬프트를 구성합니다.
파일 구조
지엑스피1
구성 및 사용자 정의
알림 구성( config/alerts_config.json )
- 사용자 정의 가능한 상한/하한 가격 임계값과 설명을 통해 주식을 부문별로 정리합니다.
- 구조의 예:
{
"Tech Giants": {
"AAPL": {"above": 200, "below": 180, "description": "Apple Inc."}
},
"Financial": {
"JPM": {"above": 160, "below": 140, "description": "JPMorgan Chase"}
}
}
환경 변수
.env 파일이나 시스템 환경에 다음을 설정합니다.
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
SERPAPI_API_KEY=your_serpapi_key
Claude Desktop에서 설치 및 실행
필수 조건
- 파이썬 3.7 이상
- Claude Desktop (또는 MCP 호환 클라이언트)
- Telegram 봇 자격 증명(알림용)
- 인터넷 연결(시장/뉴스 데이터용)
단계별 가이드
- 저장소 복제
git clone <this-repo-url>
cd Finance_MCP_Server
- 가상 환경 생성 및 활성화
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- 종속성 설치
pip install -r requirements.txt
- 환경 변수 구성
- API 키와 토큰을 사용하여 프로젝트 루트에
.env 파일을 만듭니다.TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
SERPAPI_API_KEY=your_serpapi_key
- 알림 구성 편집
config/alerts_config.json 과 config/tech_alerts_config.json 을 수정하여 주식, 섹터 및 임계값을 설정합니다.
- CLI를 사용하여 MCP 서버 설치
- MCP CLI를 사용하여 Claude Desktop용 서버를 설치하고 등록하세요.
mcp install server.py --name "Financial MCP Server"
- 이렇게 하면 서버가 사용자 지정 MCP 도구로 등록되어 Claude Desktop 및 기타 MCP 클라이언트에서 검색이 가능해집니다.
- MCP CLI를 통해 MCP 서버 실행
- MCP CLI를 사용하여 서버를 시작합니다.
- 서버가 시작되어 stdio를 통해 MCP 요청을 수신합니다.
- Claude Desktop에서 연결
- Claude Desktop에서 새로운 사용자 지정 MCP 서버 연결을 추가합니다.
- 실행 파일/명령을
mcp run server.py 로 설정합니다(또는 MCP CLI 목록에서 등록된 "재무 MCP 서버"를 선택합니다). - Claude Desktop은 MCP 프로토콜을 사용하여 서버와 통신하여 설명된 모든 도구와 엔드포인트를 활성화합니다.
예: Claude Desktop MCP 서버 구성
Financial MCP 서버를 설치하고 등록한 후 Claude Desktop 구성에 추가할 수 있습니다. 다음은 claude_desktop_config.json 파일의 샘플입니다.
{
"mcpServers": {
"Financial-MCP-Server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"server.py"
],
"env": {
"SERPAPI_API_KEY": "",
"TELEGRAM_BOT_TOKEN": "",
"TELEGRAM_USER_ID": "",
"OPENAI_API_KEY": "",
"ALPHA_VANTAGE_API_KEY": ""
}
}
}
}
- 필요에 따라 실제 API 키와 토큰으로
env 섹션을 업데이트합니다. - 이 구성을 사용하면 Claude Desktop이 올바른 환경과 명령줄 인수를 사용하여 Financial MCP 서버를 시작하고 통신할 수 있습니다.
Claude Desktop에서 도구 사용하기
맞춤형 금융 MCP 서버를 설치하고 연결하면 사용 가능한 모든 도구가 Claude Desktop의 도구 메뉴에 자동으로 나타납니다. 각 도구를 개별적으로 활성화하거나 비활성화할 수 있으므로 Claude 인터페이스에서 재무 상황 분석, 시장 요약, 포트폴리오 관리, 주식 알림 등의 기능에 쉽게 액세스할 수 있습니다.
아래는 MCP 서버의 도구가 Claude Desktop에 나열되고 전환되는 방식을 보여주는 스크린샷입니다.
- 각 도구(예:
financial_context , market_summary , add_stock 등)는 필요에 따라 활성화하거나 비활성화할 수 있습니다. - 이러한 원활한 통합을 통해 Claude Desktop에서 자연어와 도구 기반 워크플로를 사용하여 재무 분석 서버와 상호 작용할 수 있습니다.
사용 예
- 시장 요약 받기 :
market_summary 도구를 사용하여 실시간 지수, 동향 및 뉴스를 가져옵니다. - 포트폴리오 관리 :
add_stock , remove_stock , get_portfolio 를 사용하여 추적된 주식을 업데이트하고 확인하세요. - 알림 수신 : 임계값을 구성하고 가격 변동 및 거래 기회에 대한 Telegram 알림을 받습니다.
- 문맥 분석 :
financial_context 사용하여 쿼리를 분석하고, 티커를 추출하고, 요약된 뉴스와 시장에 대한 정보를 얻습니다.
문제 해결 및 로그
- 모든 로그는 프로젝트 루트의
financial_mcp.log 에 기록됩니다. - 디버깅을 위해 로그 파일을 확인하고 환경 변수와 구성 파일이 올바른지 확인하세요.
- Telegram이나 뉴스 가져오기에 문제가 발생하면 API 키와 인터넷 연결을 확인하세요.