Meeting Room MCP Server

#!/bin/bash # -*- coding: utf-8 -*- # # Meeting Room MCP 프로젝트 구조 자동 생성 스크립트 # # 사용법: # chmod +x setup_project.sh # ./setup_project.sh # set -e # 에러 발생 시 중단 echo "==========================================" echo "Meeting Room MCP 프로젝트 생성 시작" echo "==========================================" # 프로젝트 루트 확인 PROJECT_ROOT="$(pwd)" echo "프로젝트 루트: $PROJECT_ROOT" # 디렉터리 생성 echo "" echo "📁 디렉터리 생성 중..." mkdir -p auth mkdir -p api mkdir -p utils echo " ✓ auth/" echo " ✓ api/" echo " ✓ utils/" # __init__.py 파일 생성 echo "" echo "📝 __init__.py 파일 생성 중..." touch auth/__init__.py touch api/__init__.py touch utils/__init__.py echo " ✓ auth/__init__.py" echo " ✓ api/__init__.py" echo " ✓ utils/__init__.py" # ============================================================================ # config.py 생성 # ============================================================================ echo "" echo "📝 config.py 생성 중..." cat > config.py << 'EOF' # -*- coding: utf-8 -*- """ 설정 및 상수 관리 환경변수를 로드하고 전역 설정값을 관리합니다. """ import os from dotenv import load_dotenv load_dotenv() # ============================================================================ # 사용자 정보 # ============================================================================ USER_ID = os.getenv("USER_ID") USER_PASSWORD = os.getenv("USER_PASSWORD") USER_NAME = os.getenv("USER_NAME") GROUP_ID = os.getenv("GROUP_ID") GROUP_NAME = os.getenv("GROUP_NAME") # ============================================================================ # URL 설정 # ============================================================================ SSO_LOGIN_URL = os.getenv("SSO_LOGIN_URL") BASE_URL = os.getenv("MEETING_ROOM_BASE_URL") PORTAL_URL = "https://works.ktds.co.kr/group/main" # ============================================================================ # 경로 설정 # ============================================================================ CHROMEDRIVER_PATH = r"D:\workspace\meeting-room-mcp\chromedriver\chromedriver.exe" LOG_FILE = r'D:\workspace\meeting-room-mcp\mcp_debug.log' # ============================================================================ # 사무실 ID 매핑 # ============================================================================ OFFICE_MAP = { "방배": 1, "분당": 2, "가양": 3, "퓨처": 4 } # ============================================================================ # 기본 설정 # ============================================================================ DEFAULT_OFFICE = "분당" DEFAULT_OFFICE_ID = 2 DEFAULT_PAGE_SIZE = 9999 EOF echo " ✓ config.py" # ============================================================================ # auth/login.py 생성 # ============================================================================ echo "" echo "📝 auth/login.py 생성 중..." cat > auth/login.py << 'EOF' # -*- coding: utf-8 -*- """ SSO 로그인 관리 모듈 포털 로그인 후 SSO 토큰을 통해 회의실 시스템에 접근하고 세션 쿠키를 관리합니다. """ import time import re import logging from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.chrome.service import Service logger = logging.getLogger(__name__) class LoginManager: """SSO 로그인 관리 클래스""" def __init__(self, config): """ Args: config: 설정 모듈 (config.py) """ self.config = config self.session_cookies = {} def login(self): """ 전체 로그인 프로세스 실행 Returns: dict: 세션 쿠키 딕셔너리 Raises: Exception: 로그인 실패 시 """ logger.info("자동 로그인 시작...") driver = self._init_driver() try: # 1. 포털 로그인 self._login_to_portal(driver) # 2. SSO 토큰으로 회의실 시스템 접근 self._access_meeting_room_system(driver) # 3. 쿠키 수집 self._collect_cookies(driver) logger.info("로그인 완료!") return self.session_cookies except Exception as e: logger.error(f"로그인 실패: {str(e)}", exc_info=True) raise finally: driver.quit() def _init_driver(self): """Chrome 드라이버 초기화""" options = webdriver.ChromeOptions() options.add_argument('--start-maximized') options.add_argument('--disable-gpu') options.add_argument('--no-sandbox') options.add_argument('--disable-dev-shm-usage') service = Service(self.config.CHROMEDRIVER_PATH) return webdriver.Chrome(service=service, options=options) def _login_to_portal(self, driver): """포털 로그인""" logger.info("회사 포털 접속 중...") driver.get(self.config.PORTAL_URL) time.sleep(3) logger.info("로그인 폼 입력 중...") wait = WebDriverWait(driver, 10) user_id_field = wait.until(EC.presence_of_element_located((By.ID, "userId"))) user_pwd_field = driver.find_element(By.ID, "userPwd") login_button = driver.find_element(By.ID, "login_area") user_id_field.send_keys(self.config.USER_ID) user_pwd_field.send_keys(self.config.USER_PASSWORD) login_button.click() logger.info("로그인 처리 중...") time.sleep(5) def _access_meeting_room_system(self, driver): """SSO를 통한 회의실 시스템 접근""" # 방법 1: SSO 토큰 추출 if self._try_sso_token_method(driver): return # 방법 2: 버튼 클릭 if self._try_button_click_method(driver): return raise Exception("회의실 시스템 접근 실패") def _try_sso_token_method(self, driver): """SSO 토큰 추출 방식""" logger.info("SSO 토큰 추출 시도...") page_source = driver.page_source pattern = r"https://srs\.ktds\.co\.kr:8443/front/ssoLoginRoom\.do\?.*?sso_token=([^'\"]+)" matches = re.findall(pattern, page_source) if matches: sso_token = matches[0] logger.info(f"SSO 토큰 발견: {sso_token[:50]}...") sso_url = f"https://srs.ktds.co.kr:8443/front/ssoLoginRoom.do?sso_token={sso_token}" driver.get(sso_url) time.sleep(5) logger.info(f"회의실 시스템 접속 완료: {driver.current_url}") return True logger.warning("SSO 토큰을 찾지 못함") return False def _try_button_click_method(self, driver): """회의실 버튼 클릭 방식""" logger.info("회의실 버튼 클릭 방식 시도...") try: meeting_button = self._find_meeting_button(driver) if meeting_button: logger.info("회의실 버튼 클릭...") meeting_button.click() time.sleep(3) # 새 창 처리 if len(driver.window_handles) > 1: driver.switch_to.window(driver.window_handles[-1]) time.sleep(2) logger.info(f"회의실 시스템 접속 완료: {driver.current_url}") return True except Exception as e: logger.error(f"버튼 클릭 실패: {str(e)}") return False def _find_meeting_button(self, driver): """회의실 버튼 찾기 (여러 방법 시도)""" # 방법 1: ID로 찾기 try: return driver.find_element(By.ID, "_qmytodo_INSTANCE__for_personal_a_100474891") except: pass # 방법 2: 텍스트로 찾기 try: links = driver.find_elements(By.TAG_NAME, "a") for link in links: if "회의실 예약" in link.text or "회의실" in link.text: return link except: pass # 방법 3: onclick 속성으로 찾기 try: elements = driver.find_elements(By.XPATH, "//*[@onclick]") for elem in elements: onclick = elem.get_attribute("onclick") if "ssoLoginRoom" in onclick: return elem except: pass return None def _collect_cookies(self, driver): """쿠키 수집""" cookies = driver.get_cookies() logger.info(f"총 {len(cookies)}개의 쿠키 발견") for cookie in cookies: self.session_cookies[cookie['name']] = cookie['value'] logger.debug(f"쿠키: {cookie['name']}") if cookie['name'] == 'SESSION': logger.info(f"SESSION 쿠키 획득: {cookie['value'][:20]}...") if 'SESSION' not in self.session_cookies: raise Exception("SESSION 쿠키를 찾을 수 없습니다.") def get_headers(self): """ API 요청용 헤더 생성 Returns: dict: HTTP 헤더 Raises: Exception: 로그인되지 않은 경우 """ if not self.session_cookies: raise Exception("로그인이 필요합니다. login()을 먼저 호출하세요.") cookie_str = '; '.join([f"{k}={v}" for k, v in self.session_cookies.items()]) return { 'Cookie': cookie_str, 'Content-Type': 'application/json;charset=UTF-8', 'Accept': 'application/json, text/plain, */*', 'Accept-Encoding': 'gzip, deflate, br', 'Accept-Language': 'ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7', 'Referer': f'{self.config.BASE_URL}/front/allFloorsMeeting.do', 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' } EOF echo " ✓ auth/login.py" # ============================================================================ # utils/date_parser.py 생성 # ============================================================================ echo "" echo "📝 utils/date_parser.py 생성 중..." cat > utils/date_parser.py << 'EOF' # -*- coding: utf-8 -*- """ 날짜/시간 파싱 유틸리티 다양한 형식의 날짜/시간 문자열을 표준 형식으로 변환합니다. """ from datetime import datetime class DateParser: """날짜/시간 문자열 파싱 클래스""" @staticmethod def parse_date(date_str: str) -> str: """ 다양한 날짜 형식을 YYYY-MM-DD로 변환 Args: date_str: 날짜 문자열 ("10.24", "2025-10-24" 등) Returns: str: YYYY-MM-DD 형식의 날짜 Examples: >>> DateParser.parse_date("10.24") "2025-10-24" >>> DateParser.parse_date("2025-10-24") "2025-10-24" """ try: # "10.24" 형식 if '.' in date_str: parts = date_str.split('.') month = int(parts[0]) day = int(parts[1]) year = datetime.now().year return f"{year}-{month:02d}-{day:02d}" # "2025-10-24" 형식 if '-' in date_str and len(date_str) == 10: return date_str # 기본값: 오늘 return datetime.now().strftime("%Y-%m-%d") except: return datetime.now().strftime("%Y-%m-%d") @staticmethod def parse_time(time_str: str) -> str: """ 시간 문자열을 HH:00 형식으로 변환 Args: time_str: 시간 문자열 ("4시", "16:00" 등) Returns: str: HH:00 형식의 시간 Examples: >>> DateParser.parse_time("4시") "16:00" >>> DateParser.parse_time("16:00") "16:00" """ try: time_str = time_str.replace('시', '').strip() hour = int(time_str.split(':')[0]) # 1~8시는 오후로 처리 if 1 <= hour <= 8: hour += 12 return f"{hour:02d}:00" except: return "09:00" EOF echo " ✓ utils/date_parser.py" # ============================================================================ # utils/time_checker.py 생성 # ============================================================================ echo "" echo "📝 utils/time_checker.py 생성 중..." cat > utils/time_checker.py << 'EOF' # -*- coding: utf-8 -*- """ 시간대 가용성 체크 유틸리티 회의실의 예약 가능한 시간대를 찾습니다. """ import logging logger = logging.getLogger(__name__) class TimeChecker: """회의실 시간대 가용성 체크 클래스""" @staticmethod def time_to_minutes(time_str: str) -> int: """ HH:MM을 분으로 변환 Args: time_str: "HH:MM" 형식의 시간 Returns: int: 자정부터의 분 단위 시간 Examples: >>> TimeChecker.time_to_minutes("09:30") 570 """ h, m = map(int, time_str.split(':')) return h * 60 + m @classmethod def check_available_slots(cls, room_id: int, reservations: list, start_hour: int = 12, duration: int = 2) -> tuple: """ 특정 회의실의 가능한 시간대 찾기 Args: room_id: 회의실 ID reservations: 전체 예약 목록 start_hour: 검색 시작 시간 (기본: 12시) duration: 필요 시간 (시간 단위, 기본: 2시간) Returns: tuple: (가능한 시간대 리스트, 기존 예약 정보 리스트) Examples: >>> slots, reservations = TimeChecker.check_available_slots(123, all_res, 12, 2) >>> print(slots) ['12:00-14:00', '15:00-17:00'] """ # 해당 회의실의 예약 찾기 room_reservations = [] for res in reservations: try: targets = res.get('reservation', {}).get('reservationTargets', []) if targets and targets[0].get('room', {}).get('id') == room_id: start_time = res['startDateTime'][11:16] end_time = res['endDateTime'][11:16] room_reservations.append({ 'start': cls.time_to_minutes(start_time), 'end': cls.time_to_minutes(end_time), 'title': res.get('reservation', {}).get('title', '제목없음') }) except Exception as e: logger.debug(f"예약 파싱 실패: {str(e)}") continue # 가능한 시간대 찾기 available_slots = [] end_search_hour = 19 - duration # 19시 종료 가능하도록 for hour in range(start_hour, end_search_hour + 1): slot_start = hour * 60 slot_end = slot_start + (duration * 60) # 이 시간대가 비어있는지 확인 is_available = True for res in room_reservations: # 겹치는지 확인 (시작 < 기존종료 AND 종료 > 기존시작) if not (slot_end <= res['start'] or slot_start >= res['end']): is_available = False break if is_available: available_slots.append(f"{hour:02d}:00-{(hour+duration):02d}:00") return available_slots, room_reservations EOF echo " ✓ utils/time_checker.py" # ============================================================================ # api/rooms.py 생성 # ============================================================================ echo "" echo "📝 api/rooms.py 생성 중..." cat > api/rooms.py << 'EOF' # -*- coding: utf-8 -*- """ 회의실 API 모듈 회의실 목록 조회, 검색, 필터링 기능을 제공합니다. """ import logging import requests from urllib3.exceptions import InsecureRequestWarning requests.packages.urllib3.disable_warnings(InsecureRequestWarning) logger = logging.getLogger(__name__) class RoomsAPI: """회의실 관련 API 클래스""" def __init__(self, base_url: str, login_manager): """ Args: base_url: 회의실 시스템 베이스 URL login_manager: LoginManager 인스턴스 """ self.base_url = base_url self.login_manager = login_manager def get_all_rooms(self, office_id: int = 2, size: int = 9999): """ 전체 회의실 목록 조회 Args: office_id: 사무실 ID (1:방배, 2:분당, 3:가양, 4:퓨처) size: 조회할 최대 개수 Returns: list: 회의실 목록 Raises: Exception: API 호출 실패 시 """ url = f"{self.base_url}/room/api/v1/rooms" params = { "officeId": office_id, "size": size, "valid": "true", "sort": "name,asc" } logger.info(f"회의실 목록 조회: officeId={office_id}") response = requests.get( url, headers=self.login_manager.get_headers(), params=params, verify=False ) if response.status_code == 200: rooms = response.json() logger.info(f"회의실 {len(rooms)}개 조회 완료") return rooms else: raise Exception(f"회의실 목록 조회 실패: {response.status_code}") def filter_by_floor(self, rooms: list, floor_filter: str) -> list: """ 층으로 회의실 필터링 Args: rooms: 전체 회의실 목록 floor_filter: 층 정보 ("7층", "7F", "12F_A" 등) Returns: list: 필터링된 회의실 목록 """ if not floor_filter: return rooms floor_filter = floor_filter.replace('층', '').strip() filtered = [r for r in rooms if floor_filter in r['floorName']] logger.info(f"층 필터링: {floor_filter} → {len(filtered)}개") return filtered def get_room_by_name(self, room_name: str, office_id: int = 2) -> dict: """ 이름으로 회의실 찾기 Args: room_name: 회의실 이름 (부분 일치) office_id: 사무실 ID Returns: dict: 회의실 정보 (없으면 None) """ rooms = self.get_all_rooms(office_id) for room in rooms: if room_name in room['name']: logger.info(f"회의실 발견: {room['name']}") return room logger.warning(f"회의실을 찾을 수 없음: {room_name}") return None EOF echo " ✓ api/rooms.py" # ============================================================================ # api/reservations.py 생성 # ============================================================================ echo "" echo "📝 api/reservations.py 생성 중..." cat > api/reservations.py << 'EOF' # -*- coding: utf-8 -*- """ 예약 API 모듈 예약 현황 조회 및 예약 생성 기능을 제공합니다. """ import logging import requests from urllib3.exceptions import InsecureRequestWarning requests.packages.urllib3.disable_warnings(InsecureRequestWarning) logger = logging.getLogger(__name__) class ReservationsAPI: """예약 관련 API 클래스""" def __init__(self, base_url: str, login_manager, config): """ Args: base_url: 회의실 시스템 베이스 URL login_manager: LoginManager 인스턴스 config: 설정 모듈 """ self.base_url = base_url self.login_manager = login_manager self.config = config def get_reservations(self, date: str, office_id: int = 2): """ 예약 현황 조회 Args: date: 날짜 (YYYY-MM-DD) office_id: 사무실 ID Returns: list: 예약 목록 (실패 시 빈 리스트) """ url = f"{self.base_url}/room/api/v1/reservations/-/reserved-dates" params = { "officeId": office_id, "useDate": date, "reservedDateStatus": "RESERVED,ENTRANCE,LEAVING", "page": 0, "size": 3600 } logger.info(f"예약 조회: date={date}, officeId={office_id}") response = requests.get( url, headers=self.login_manager.get_headers(), params=params, verify=False ) if response.status_code == 200: reservations = response.json() logger.info(f"예약 {len(reservations)}개 조회 완료") return reservations else: logger.warning(f"예약 조회 실패: {response.status_code}") return [] def create_reservation(self, room: dict, date: str, start_time: str, end_time: str, title: str = "회의"): """ 예약 생성 Args: room: 회의실 정보 딕셔너리 date: 날짜 (YYYY-MM-DD) start_time: 시작 시간 (HH:MM) end_time: 종료 시간 (HH:MM) title: 회의 제목 Returns: requests.Response: API 응답 객체 """ url = f"{self.base_url}/room/api/v1/reservations" reservation_data = { "id": "", "title": title, "startDateTime": f"{date} {start_time}", "endDateTime": f"{date} {end_time}", "organizerId": self.config.USER_ID, "organizerName": self.config.USER_NAME, "organizerGroupId": self.config.GROUP_ID, "organizerGroupName": self.config.GROUP_NAME, "status": "RESERVED", "useAllDay": False, "useRecurrence": False, "useResponse": False, "eventId": "", "visibility": None, "recurrence": {}, "reservationTargets": [{ "roomId": room['id'], "attendees": [{ "attendeeId": self.config.USER_ID, "attendeeType": "INNER_PERSON", "displayName": f"{self.config.USER_NAME} 전임", "companyName": self.config.GROUP_NAME, "email": "", "mobileNo": "" }] }] } logger.info(f"예약 생성: {room['name']}, {date} {start_time}-{end_time}") response = requests.post( url, headers=self.login_manager.get_headers(), json=reservation_data, verify=False ) if response.status_code == 201: logger.info("예약 생성 성공") else: logger.error(f"예약 생성 실패: {response.status_code}") return response EOF echo " ✓ api/reservations.py" # ============================================================================ # meeting_room_mcp.py 메인 파일 생성 (간단 버전) # ============================================================================ echo "" echo "📝 meeting_room_mcp.py 생성 중..." cat > meeting_room_mcp.py << 'EOF' # -*- coding: utf-8 -*- """ 회의실 예약 MCP 서버 (메인) 주요 기능: 1. SSO 로그인을 통한 회의실 시스템 접근 2. 회의실 검색 (시간대별, 층별) 3. 예약 현황 조회 4. 예약 생성 """ import os import sys import asyncio import logging from typing import Any # Windows 한글 인코딩 설정 if sys.platform == 'win32': sys.stdout.reconfigure(encoding='utf-8') sys.stderr.reconfigure(encoding='utf-8') # 로깅 설정 logging.basicConfig( filename='mcp_debug.log', level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s', encoding='utf-8' ) logger = logging.getLogger(__name__) # MCP 관련 import from mcp.server import Server from mcp.types import Tool, TextContent # 커스텀 모듈 import import config from auth.login import LoginManager from api.rooms import RoomsAPI from api.reservations import ReservationsAPI from utils.date_parser import DateParser from utils.time_checker import TimeChecker # ============================================================================ # 전역 변수 # ============================================================================ login_manager = None rooms_api = None reservations_api = None app = Server("meeting-room-mcp") # ============================================================================ # 초기화 # ============================================================================ def initialize_services(): """서비스 초기화""" global login_manager, rooms_api, reservations_api login_manager = LoginManager(config) rooms_api = RoomsAPI(config.BASE_URL, login_manager) reservations_api = ReservationsAPI(config.BASE_URL, login_manager, config) logger.info("서비스 초기화 완료") def ensure_login(): """로그인 상태 확인 및 필요시 로그인""" global login_manager if not login_manager or not login_manager.session_cookies: logger.info("세션 없음. 로그인 시도...") login_manager.login() # ============================================================================ # MCP Tools 정의 # ============================================================================ @app.list_tools() async def list_tools() -> list[Tool]: """사용 가능한 도구 목록""" return [ Tool( name="search_available_rooms", description="특정 날짜와 시간대에 예약 가능한 회의실 검색", inputSchema={ "type": "object", "properties": { "date": { "type": "string", "description": "날짜 (예: '10.24', '2025-10-24')" }, "office": { "type": "string", "description": "사무실 위치 (분당, 방배, 가양, 퓨처)", "default": "분당" }, "floor": { "type": "string", "description": "층 정보 (예: '7층', '12F_A')", "default": "" }, "start_hour": { "type": "integer", "description": "시작 시간 (예: 12)", "default": 9 }, "duration": { "type": "integer", "description": "필요 시간 (시간 단위, 예: 2)", "default": 1 } }, "required": ["date"] } ), Tool( name="get_room_details", description="특정 회의실의 상세 정보 및 예약 현황 조회", inputSchema={ "type": "object", "properties": { "room_name": { "type": "string", "description": "회의실 이름 (예: '705 회의실', '1202')" }, "date": { "type": "string", "description": "날짜" } }, "required": ["room_name", "date"] } ), Tool( name="create_reservation", description="회의실 예약 생성", inputSchema={ "type": "object", "properties": { "room_name": { "type": "string", "description": "회의실 이름 (예: '705 회의실')" }, "date": { "type": "string", "description": "날짜" }, "start_time": { "type": "string", "description": "시작 시간 (예: '16:00', '4시')" }, "end_time": { "type": "string", "description": "종료 시간 (예: '18:00', '6시')" }, "title": { "type": "string", "description": "회의 제목", "default": "회의" } }, "required": ["room_name", "date", "start_time", "end_time"] } ) ] @app.call_tool() async def call_tool(name: str, arguments: Any) -> list[TextContent]: """도구 실행""" logger.info(f"Tool called: {name} with args: {arguments}") try: ensure_login() if name == "search_available_rooms": return await search_available_rooms(arguments) elif name == "get_room_details": return await get_room_details(arguments) elif name == "create_reservation": return await create_reservation(arguments) else: return [TextContent(type="text", text=f"Unknown tool: {name}")] except Exception as e: logger.error(f"오류 발생: {str(e)}", exc_info=True) return [TextContent(type="text", text=f"오류 발생: {str(e)}")] # ============================================================================ # Tool 구현 # ============================================================================ async def search_available_rooms(args: dict) -> list[TextContent]: """예약 가능한 회의실 검색""" logger.info(f"search_available_rooms 호출: {args}") date = DateParser.parse_date(args.get("date", "")) office = args.get("office", "분당") floor_filter = args.get("floor", "") start_hour = args.get("start_hour", 9) duration = args.get("duration", 1) office_id = config.OFFICE_MAP.get(office, 2) try: all_rooms = rooms_api.get_all_rooms(office_id) if floor_filter: all_rooms = rooms_api.filter_by_floor(all_rooms, floor_filter) reservations = reservations_api.get_reservations(date, office_id) result = f"[{date}] {office} 회의실 현황\n" result += f"검색 조건: {start_hour}시 이후 {duration}시간 사용 가능\n\n" available_count = 0 for room in all_rooms: slots, room_reservations = TimeChecker.check_available_slots( room['id'], reservations, start_hour, duration ) if slots: available_count += 1 result += f"✅ {room['name']} ({room['floorName']}, {room['personnel']}명)\n" result += f" 가능 시간:\n" for slot in slots: result += f" • {slot}\n" if room_reservations: result += f" 기존 예약:\n" for res in room_reservations: h_start = res['start'] // 60 m_start = res['start'] % 60 h_end = res['end'] // 60 m_end = res['end'] % 60 result += f" • {h_start:02d}:{m_start:02d}~{h_end:02d}:{m_end:02d} ({res['title']})\n" result += "\n" if available_count == 0: result += "❌ 조건에 맞는 회의실이 없습니다.\n" else: result += f"\n총 {available_count}개 회의실 예약 가능!" return [TextContent(type="text", text=result)] except Exception as e: return [TextContent(type="text", text=f"검색 실패: {str(e)}")] async def get_room_details(args: dict) -> list[TextContent]: """회의실 상세 정보 조회""" logger.info(f"get_room_details 호출: {args}") room_name = args.get("room_name", "") date = DateParser.parse_date(args.get("date", "")) try: room = rooms_api.get_room_by_name(room_name) if not room: return [TextContent(type="text", text=f"'{room_name}' 회의실을 찾을 수 없습니다.")] office_id = room.get('officeId', 2) reservations = reservations_api.get_reservations(date, office_id) room_reservations = [] for res in reservations: try: targets = res.get('reservation', {}).get('reservationTargets', []) if targets and targets[0].get('room', {}).get('id') == room['id']: room_reservations.append(res) except: continue result = f"[회의실 정보] {room['name']}\n\n" result += f"위치: {room.get('officeName', 'N/A')} {room.get('floorName', 'N/A')}\n" result += f"수용 인원: {room.get('personnel', 'N/A')}명\n" result += f"체크인 필요: {'예' if room.get('useCheckInOut', False) else '아니오'}\n\n" if room_reservations: result += f"[{date} 예약 현황]\n" for res in room_reservations: title = res.get('reservation', {}).get('title', '제목없음') start = res.get('startDateTime', 'N/A')[11:16] end = res.get('endDateTime', 'N/A')[11:16] organizer = res.get('reservation', {}).get('organizerName', 'N/A') result += f" • {start}~{end}: {title} (예약자: {organizer})\n" else: result += f"[{date}] 예약 없음 - 종일 사용 가능\n" return [TextContent(type="text", text=result)] except Exception as e: return [TextContent(type="text", text=f"조회 실패: {str(e)}")] async def create_reservation(args: dict) -> list[TextContent]: """회의실 예약 생성""" logger.info(f"create_reservation 호출: {args}") room_name = args.get("room_name", "") date = DateParser.parse_date(args.get("date", "")) start_time = DateParser.parse_time(args.get("start_time", "")) end_time = DateParser.parse_time(args.get("end_time", "")) title = args.get("title", "회의") try: room = rooms_api.get_room_by_name(room_name) if not room: return [TextContent(type="text", text=f"'{room_name}' 회의실을 찾을 수 없습니다.")] response = reservations_api.create_reservation( room, date, start_time, end_time, title ) if response.status_code == 201: result_data = response.json() result = f"[예약 완료]\n\n" result += f"회의실: {room['name']}\n" result += f"날짜: {date}\n" result += f"시간: {start_time} ~ {end_time}\n" result += f"제목: {title}\n" result += f"예약 ID: {result_data.get('id')}" return [TextContent(type="text", text=result)] else: return [TextContent(type="text", text=f"예약 실패: {response.status_code}\n{response.text}")] except Exception as e: return [TextContent(type="text", text=f"예약 실패: {str(e)}")] # ============================================================================ # 메인 실행 # ============================================================================ async def main(): """MCP 서버 실행""" from mcp.server.stdio import stdio_server logger.info("MCP 서버 시작") initialize_services() async with stdio_server() as (read_stream, write_stream): await app.run( read_stream, write_stream, app.create_initialization_options() ) if __name__ == "__main__": import warnings warnings.filterwarnings('ignore', message='Unverified HTTPS request') asyncio.run(main()) EOF echo " ✓ meeting_room_mcp.py" # ============================================================================ # README.md 생성 # ============================================================================ echo "" echo "📝 README.md 생성 중..." cat > README.md << 'EOF' # Meeting Room MCP 회의실 예약 시스템을 위한 MCP (Model Context Protocol) 서버 ## 📁 프로젝트 구조 ``` meeting-room-mcp/ ├── meeting_room_mcp.py # 메인 MCP 서버 ├── config.py # 설정 및 상수 ├── auth/ │ ├── __init__.py │ └── login.py # SSO 로그인 관리 ├── api/ │ ├── __init__.py │ ├── rooms.py # 회의실 API │ └── reservations.py # 예약 API ├── utils/ │ ├── __init__.py │ ├── date_parser.py # 날짜/시간 파싱 │ └── time_checker.py # 시간대 체크 ├── requirements.txt ├── .env └── README.md ``` ## 🚀 설치 및 실행 1. 가상환경 생성 및 활성화 ```bash python -m venv venv source venv/bin/activate # Linux/Mac # 또는 venv\Scripts\activate # Windows ``` 2. 의존성 설치 ```bash pip install -r requirements.txt ``` 3. .env 파일 설정 ```env USER_ID=your_id USER_PASSWORD=your_password USER_NAME=your_name GROUP_ID=your_group_id GROUP_NAME=your_group_name MEETING_ROOM_BASE_URL=https://srs.ktds.co.kr:8443 ``` 4. MCP 서버 실행 ```bash python meeting_room_mcp.py ``` ## 🔧 주요 기능 ### 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: 회의 제목 (선택) ## 📝 로그 모든 로그는 `mcp_debug.log` 파일에 기록됩니다. ## 🔐 인증 SSO 토큰 기반 자동 로그인을 사용합니다. - 포털 로그인 - SSO 토큰 추출 - 회의실 시스템 접근 - 세션 쿠키 관리 EOF echo " ✓ README.md" # ============================================================================ # 완료 메시지 # ============================================================================ echo "" echo "==========================================" echo "✅ 프로젝트 생성 완료!" echo "==========================================" echo "" echo "생성된 파일:" echo " 📁 auth/" echo " └── login.py" echo " 📁 api/" echo " ├── rooms.py" echo " └── reservations.py" echo " 📁 utils/" echo " ├── date_parser.py" echo " └── time_checker.py" echo " 📄 config.py" echo " 📄 meeting_room_mcp.py" echo " 📄 README.md" echo "" echo "다음 단계:" echo " 1. .env 파일 확인 및 수정" echo " 2. requirements.txt 확인" echo " 3. python meeting_room_mcp.py 실행" echo ""