Meeting Room MCP Server

# Meeting Room MCP 🏢 회의실 예약 시스템을 Claude Desktop과 연동하는 MCP (Model Context Protocol) 서버 ## ✨ 주요 기능 - 🔍 **회의실 검색**: 날짜, 시간, 층별로 예약 가능한 회의실 검색 - 📋 **예약 현황 조회**: 특정 회의실의 예약 현황 확인 - 📝 **예약 생성**: Claude를 통한 자동 회의실 예약 - 🔐 **SSO 자동 로그인**: Selenium 기반 자동 인증 ## 📁 프로젝트 구조 ``` meeting-room-mcp/ ├── meeting_room_mcp.py # 메인 MCP 서버 ├── config.py # 설정 관리 ├── auth/ # 인증 모듈 │ └── login.py # SSO 로그인 ├── api/ # API 모듈 │ ├── rooms.py # 회의실 API │ └── reservations.py # 예약 API ├── utils/ # 유틸리티 │ ├── date_parser.py # 날짜/시간 파싱 │ └── time_checker.py # 시간대 체크 └── setup_project.sh # 프로젝트 자동 생성 스크립트 ``` ## 🚀 빠른 시작 ### 1. 프로젝트 클론 ```bash git clone https://github.com/your-username/meeting-room-mcp.git cd meeting-room-mcp ``` ### 2. 자동 설치 (Linux/Mac/Git Bash) ```bash chmod +x setup_project.sh ./setup_project.sh ``` ### 3. 수동 설치 (Windows) ```bash # 가상환경 생성 python -m venv venv # 가상환경 활성화 .\venv\Scripts\activate # Windows # source venv/bin/activate # Linux/Mac # 의존성 설치 pip install -r requirements.txt ``` ### 4. 환경 설정 ```bash # .env.example을 복사하여 .env 생성 cp .env.example .env # .env 파일 수정 (실제 정보 입력) notepad .env # Windows # nano .env # Linux/Mac ``` ### 5. ChromeDriver 설치 1. Chrome 버전 확인: `chrome://version` 2. [ChromeDriver 다운로드](https://googlechromelabs.github.io/chrome-for-testing/) 3. `chromedriver/` 폴더에 저장 4. `.env`의 `CHROMEDRIVER_PATH` 경로 수정 ### 6. Claude Desktop 설정 `claude_desktop_config.json` 파일 수정: **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "meeting-room": { "command": "C:\\path\\to\\venv\\Scripts\\python.exe", "args": ["-u", "C:\\path\\to\\meeting_room_mcp.py"] } } } ``` ### 7. Claude Desktop 재시작 1. Claude Desktop 완전 종료 2. 재실행 3. 새 대화 시작 ## 💬 사용 예시 Claude Desktop에서 다음처럼 물어보세요: ``` 오늘 분당 7층에서 오후 2시 이후 2시간 사용 가능한 회의실 찾아줘 705 회의실 내일 예약 현황 알려줘 내일 오후 4시부터 6시까지 705 회의실 "프로젝트 리뷰" 제목으로 예약해줘 ``` ## 🛠️ 제공되는 도구 ### 1. `search_available_rooms` **파라미터:** - `date`: 날짜 (예: "10.24", "2025-10-24") - `office`: 사무실 (분당, 방배, 가양, 퓨처) - `floor`: 층 (예: "7층", "12F_A") - `start_hour`: 시작 시간 (기본: 9) - `duration`: 필요 시간(시간 단위, 기본: 1) ### 2. `get_room_details` **파라미터:** - `room_name`: 회의실 이름 - `date`: 날짜 ### 3. `create_reservation` **파라미터:** - `room_name`: 회의실 이름 - `date`: 날짜 - `start_time`: 시작 시간 - `end_time`: 종료 시간 - `title`: 회의 제목 (선택) ## 🏗️ 아키텍처 ### 실행 흐름 ``` Claude Desktop ↓ MCP Server (meeting_room_mcp.py) ↓ Auth Module (SSO 로그인) ↓ API Modules (회의실/예약 API) ↓ 회의실 시스템 (srs.ktds.co.kr) ``` ### 로그인 프로세스 ``` 포털 로그인 (works.ktds.co.kr) ↓ SSO 토큰 추출 (HTML 파싱 또는 버튼 클릭) ↓ 회의실 시스템 로그인 (ssoLoginRoom.do) ↓ SESSION 쿠키 획득 ↓ API 호출 ``` ## 📝 로그 확인 ```bash # 프로젝트 로그 tail -f mcp_debug.log # Claude Desktop 로그 (Windows) type %APPDATA%\Claude\logs\mcp.log # Claude Desktop 로그 (Mac) tail -f ~/Library/Logs/Claude/mcp.log ``` ## 🔧 문제 해결 ### 로그인 실패 1. `.env` 파일의 ID/비밀번호 확인 2. ChromeDriver 버전과 Chrome 버전 일치 확인 3. `mcp_debug.log` 파일 확인 ### MCP 서버 연결 안 됨 1. `claude_desktop_config.json` 경로 확인 2. Claude Desktop 완전 재시작 3. 새 대화 시작 ### Import 에러 ```bash # PYTHONPATH 설정 export PYTHONPATH=/path/to/meeting-room-mcp:$PYTHONPATH # 또는 의존성 재설치 pip install -r requirements.txt ``` ## 🤝 기여하기 1. Fork the Project 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the Branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request ## 📄 라이선스 이 프로젝트는 MIT 라이선스를 따릅니다. ## 🙏 감사의 글 - [Model Context Protocol](https://modelcontextprotocol.io/) - [Anthropic Claude](https://www.anthropic.com/) - [Selenium](https://www.selenium.dev/) ## 📧 문의 프로젝트 관련 문의사항이 있으시면 Issue를 등록해주세요. ---