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. 프로젝트 클론

git clone https://github.com/your-username/meeting-room-mcp.git
cd meeting-room-mcp

2. 자동 설치 (Linux/Mac/Git Bash)

chmod +x setup_project.sh
./setup_project.sh

3. 수동 설치 (Windows)

# 가상환경 생성
python -m venv venv

# 가상환경 활성화
.\venv\Scripts\activate  # Windows
# source venv/bin/activate  # Linux/Mac

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

4. 환경 설정

# .env.example을 복사하여 .env 생성
cp .env.example .env

# .env 파일 수정 (실제 정보 입력)
notepad .env  # Windows
# nano .env   # Linux/Mac

5. ChromeDriver 설치

1. Chrome 버전 확인: chrome://version
2. ChromeDriver 다운로드
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

{
  "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 호출

📝 로그 확인

# 프로젝트 로그
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 에러

# 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
• Anthropic Claude
• Selenium

📧 문의

프로젝트 관련 문의사항이 있으시면 Issue를 등록해주세요.

---