서울시 교통 데이터 MCP 서버

서울시의 다양한 교통 데이터를 통합하여 제공하는 MCP(Message Control Protocol) 서버입니다.

제공 데이터

1. 실시간 대중교통 정보

• 버스 도착 정보
• 지하철 도착/위치 정보
• 혼잡도 정보

2. 교통 상황 정보

• 실시간 도로 소통 정보
• 돌발 상황 정보
• CCTV 정보

3. 공공자전거(따릉이) 정보

• 실시간 대여소 현황
• 대여/반납 정보
• 이용 통계

4. 교통 통계 정보

• 교통량 통계
• 속도 정보
• 출발지-목적지(OD) 데이터

시작하기

요구사항

• Python 3.8+
• FastAPI
• Redis
• PostgreSQL

설치

# 저장소 클론
git clone https://github.com/CaChiJ/traffic-data-mcp-server.git
cd traffic-data-mcp-server

# 가상환경 생성 및 활성화
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 의존성 설치
pip install -r requirements.txt

# 환경변수 설정
cp .env.example .env
# .env 파일을 열어 필요한 설정값 입력

# 서버 실행
python main.py

환경변수 설정

# .env 파일
DATABASE_URL=postgresql://user:password@localhost:5432/traffic_db
REDIS_URL=redis://localhost:6379
SEOUL_API_KEY=your_seoul_data_api_key
PORT=8000

API 문서

서버 실행 후 다음 URL에서 API 문서를 확인할 수 있습니다:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

데이터 갱신 주기

• 실시간 데이터: 1-5분
• 통계 데이터: 1시간-1일

라이선스

MIT License

기여하기

1. 이 저장소를 포크합니다.
2. 새로운 브랜치를 생성합니다: git checkout -b feature/기능명
3. 변경사항을 커밋합니다: git commit -am 'feat: 새로운 기능 추가'
4. 브랜치를 푸시합니다: git push origin feature/기능명
5. Pull Request를 생성합니다.