FSS Pension MCP Server

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 배포 지원

🚀 주요 기능

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

cd fss_pension_mcp_server
pip install -r requirements.txt

# 환경변수 설정
export FSS_SERVICE_KEY="your_fss_api_key"

# 서버 실행
python fss_pension_server.py

Web Service

cd fss_pension_web
pip install -r requirements.txt

# 환경변수 설정
export FSS_SERVICE_KEY="your_fss_api_key"
export OPENAI_API_KEY="your_openai_api_key"

# 웹 서비스 실행
python3 simple_app.py

브라우저에서 http://localhost:8000 접속

🌐 Railway 배포

1. GitHub 연결

git clone https://github.com/ddoriboo/pension-mcp.git
cd pension-mcp/fss_pension_web

2. Railway 설정

• Railway 대시보드에서 GitHub 저장소 연결
• fss_pension_web 디렉토리를 루트로 설정

3. 환경변수 설정

FSS_SERVICE_KEY=your_actual_fss_api_key
OPENAI_API_KEY=your_actual_openai_api_key

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

1. 금융감독원 통합연금포털 접속
2. 회원가입 후 API 키 신청
3. 승인 후 발급된 키 사용

OpenAI API Key

1. OpenAI Platform 접속
2. API 키 생성
3. GPT-4 액세스 권한 확인

🤝 기여하기

1. Fork this repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

📄 라이선스

MIT License - 자세한 내용은 LICENSE 파일 참조

📞 문의

• 이슈: GitHub Issues
• 데이터 출처: 금융감독원 통합연금포털
• MCP 프로토콜: Anthropic MCP

---

🎯 실제 FSS 데이터 기반 연금 전문가 서비스
정확하고 신뢰할 수 있는 연금 상담을 AI와 함께 경험해보세요!