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

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

OpenAI API Key

OpenAI Platform 접속
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와 함께 경험해보세요!

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Provides FSS (Korean Financial Supervisory Service) pension data to AI models like Claude through Model Context Protocol, enabling real-time pension product information retrieval and personalized AI-based pension consultation services.

Related MCP Servers

MCP Feishu Project Manager
Roland0511
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Feishu project management systems, allowing retrieval of project views and work items.
Last updated -
4
5
Python
MIT License
Feishu MCP Server
sdd330
-
security
A
license
-
quality
An MCP-based service that enables AI models to seamlessly interact with Feishu (Lark) platform, supporting document reading and chatbot messaging capabilities.
Last updated -
8
37
TypeScript
MIT License
Filesystem MCP Server
QuantGeekDev
-
security
F
license
-
quality
A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
Last updated -
263
6
TypeScript
MCP-FREDAPI
Jaldekoa
A
security
A
license
A
quality
Provides access to economic data from the Federal Reserve Bank of St. Louis (FRED) through the Model Context Protocol, allowing AI assistants to retrieve economic time series data directly.
Last updated -
1
2
Python
MIT License

View all related MCP servers

FSS Pension MCP Server