재무 MCP 서버
고급 재무 분석, 주식 모니터링 및 실시간 시장 정보를 위한 맞춤형 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 포트폴리오 관리, 시장 요약, 주식 알림 및 상황별 재무 인사이트를 위한 다양한 도구와 API 엔드포인트를 제공하며, Claude Desktop 및 기타 MCP 호환 클라이언트와 원활하게 통합되도록 설계되었습니다.
주요 특징
실시간 주가 모니터링 : 사용자가 정의한 주식 및 임계값에 대한 가격 변동을 추적하고 알림을 보냅니다.
포트폴리오 관리 : 지속적인 포트폴리오에서 추적된 주식을 추가, 제거 및 확인합니다.
시장 요약 : 지수, 주요 상승/하락 종목, 뉴스 헤드라인을 포함한 글로벌 시장 데이터를 실시간으로 검색합니다.
상황에 맞는 재무 통찰력 : 사용자 쿼리를 분석하고, 재무 개체를 추출하고, 관련 뉴스를 가져와 요약하고, 실행 가능한 메시지를 생성합니다.
자동 알림 : 가격 임계값, 거래 기회, 시스템 오류에 대한 Telegram 알림을 받습니다.
사용자 정의 가능한 구성 : 유연한 알림을 위한 JSON 기반 섹터 및 주식 구성.
강력한 로깅 및 오류 처리 : 투명성과 문제 해결을 위한 자세한 로그 및 오류 메시지.
Related MCP server: MCP Server
시스템 개요
핵심 엔드포인트 및 도구
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 )
사용자 정의 가능한 상한/하한 가격 임계값과 설명을 통해 주식을 부문별로 정리합니다.
구조의 예:
환경 변수
.env 파일이나 시스템 환경에 다음을 설정합니다.
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를 사용하여 서버를 시작합니다.
mcp run server.py서버가 시작되어 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 파일의 샘플입니다.
필요에 따라 실제 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 키와 인터넷 연결을 확인하세요.
