Used for building the web interface of the pension consultation service
Visualizes pension market data and statistics in dashboards
Used for styling the pension consultation web interface
Supports containerized deployment of the pension services
Powers the backend API for serving pension data and AI consultations
Enables version control and automated deployment to Railway
Used for the web interface of the pension consultation service
Enables interactive features in the pension consultation web interface
Utilizes GPT-4 for personalized pension consultations, recommendations, and retirement scenario analysis
Used to implement the pension MCP server and web service
Enables deployment and hosting of the pension web service with automatic GitHub integration
FSS Pension MCP Server & AI Consultation Service
한국 금융감독원(FSS) 연금 데이터를 활용한 MCP 서버와 AI 기반 연금 상담 웹 서비스
📋 프로젝트 구성
이 저장소는 두 개의 주요 컴포넌트로 구성되어 있습니다:
1. 🔌 MCP Server (fss_pension_mcp_server/)
Model Context Protocol 기반 연금 데이터 서버
Claude와 같은 AI 모델에 FSS 연금 데이터 제공
실시간 연금 상품 정보 및 통계 조회
2. 🌐 Web Service (fss_pension_web/)
AI 기반 연금 상담 웹 애플리케이션
OpenAI GPT-4를 활용한 개인 맞춤형 연금 추천
Railway 배포 지원
Related MCP server: Feishu MCP Server
🚀 주요 기능
MCP Server
✅ FSS OpenAPI 실시간 데이터 연동
✅ 연금상품 검색 및 필터링
✅ 수수료율 최저가 상품 분석
✅ 회사별 성과 순위 제공
✅ 연금 통계 데이터 제공
Web Service
🤖 AI 연금 전문가: GPT-4 기반 맞춤형 상담
📊 실시간 대시보드: FSS 데이터 기반 시장 현황
👤 개인화 추천: 나이, 소득, 위험성향 고려
📈 은퇴 시나리오: 구체적인 은퇴 계획 분석
💬 직관적 채팅 UI: 전문 상담사와 대화하는 경험
🛠 기술 스택
Backend: Python 3.11, FastAPI, MCP Protocol
AI: OpenAI GPT-4
Data: FSS OpenAPI (금융감독원)
Frontend: HTML5, CSS3, JavaScript, Bootstrap 5
Deployment: Railway, Docker
Charts: Chart.js
📦 설치 및 실행
MCP Server
Web Service
브라우저에서 http://localhost:8000 접속
🌐 Railway 배포
1. GitHub 연결
2. Railway 설정
Railway 대시보드에서 GitHub 저장소 연결
fss_pension_web디렉토리를 루트로 설정
3. 환경변수 설정
4. 자동 배포
GitHub push 시 자동 배포
헬스체크:
/api/health
📡 API 문서
MCP Server Tools
get_pension_products: 연금상품 목록 조회search_products: 조건별 상품 검색get_low_fee_products: 저비용 상품 분석get_company_ranking: 회사별 순위get_pension_statistics: 연금 통계
Web Service API
GET /api/market-summary: 시장 요약POST /api/ai-chat-with-profile: AI 상담POST /api/ai-recommendation: 개인화 추천POST /api/retirement-scenario: 은퇴 시나리오 분석
📊 데이터 소스
금융감독원 통합연금포털 OpenAPI
실시간 데이터 업데이트 (2023년 4분기 기준)
1,900+ 연금 상품 분석
은행, 자산운용, 보험사 전체 데이터
🔐 API 키 발급
FSS API Key
금융감독원 통합연금포털 접속
회원가입 후 API 키 신청
승인 후 발급된 키 사용
OpenAI API Key
API 키 생성
GPT-4 액세스 권한 확인
🤝 기여하기
Fork this repository
Create feature branch (
git checkout -b feature/amazing-feature)Commit changes (
git commit -m 'Add amazing feature')Push to branch (
git push origin feature/amazing-feature)Open Pull Request
📄 라이선스
MIT License - 자세한 내용은 LICENSE 파일 참조
📞 문의
이슈: GitHub Issues
데이터 출처: 금융감독원 통합연금포털
MCP 프로토콜: Anthropic MCP
🎯 실제 FSS 데이터 기반 연금 전문가 서비스
정확하고 신뢰할 수 있는 연금 상담을 AI와 함께 경험해보세요!