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 설치

Chrome 버전 확인: chrome://version
ChromeDriver 다운로드
chromedriver/ 폴더에 저장
.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 재시작

Claude Desktop 완전 종료
재실행
새 대화 시작

💬 사용 예시

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

🔧 문제 해결

로그인 실패

.env 파일의 ID/비밀번호 확인
ChromeDriver 버전과 Chrome 버전 일치 확인
mcp_debug.log 파일 확인

MCP 서버 연결 안 됨

claude_desktop_config.json 경로 확인
Claude Desktop 완전 재시작
새 대화 시작

Import 에러

# PYTHONPATH 설정 export PYTHONPATH=/path/to/meeting-room-mcp:$PYTHONPATH # 또는 의존성 재설치 pip install -r requirements.txt

🤝 기여하기

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

Meeting Room MCP Server

Meeting Room MCP 🏢

✨ 주요 기능

📁 프로젝트 구조

🚀 빠른 시작

1. 프로젝트 클론

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

3. 수동 설치 (Windows)

4. 환경 설정

5. ChromeDriver 설치

6. Claude Desktop 설정

7. Claude Desktop 재시작

💬 사용 예시

🛠️ 제공되는 도구

1. `search_available_rooms`

2. `get_room_details`

3. `create_reservation`

🏗️ 아키텍처

실행 흐름

로그인 프로세스

📝 로그 확인

🔧 문제 해결

로그인 실패

MCP 서버 연결 안 됨

Import 에러

🤝 기여하기

📄 라이선스

🙏 감사의 글

📧 문의

New MCP Servers

MCP directory API

Meeting Room MCP 🏢

✨ 주요 기능

📁 프로젝트 구조

🚀 빠른 시작

1. 프로젝트 클론

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

3. 수동 설치 (Windows)

4. 환경 설정

5. ChromeDriver 설치

6. Claude Desktop 설정

7. Claude Desktop 재시작

💬 사용 예시

🛠️ 제공되는 도구

1. search_available_rooms

2. get_room_details

3. create_reservation

🏗️ 아키텍처

실행 흐름

로그인 프로세스

📝 로그 확인

🔧 문제 해결

로그인 실패

MCP 서버 연결 안 됨

Import 에러

🤝 기여하기

📄 라이선스

🙏 감사의 글

📧 문의

New MCP Servers

MCP directory API

1. `search_available_rooms`

2. `get_room_details`

3. `create_reservation`