Meeting Room MCP Server

会议室 MCP 🏢

与Claude Desktop联动的会议室预约系统MCP（模型上下文协议）服务器

✨ 主要功能

• 🔍（放大镜图标，通常表示搜索、查看细节或调查） 会议室搜索按日期、时间、楼层搜索可预订的会议室
• 📋（清单/条目） 查看预约状态查看特定会议室的预订情况
• 📝 一个带有笔的方框符号，常用于表示笔记、记录或待办事项。 创建预约通过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. 开始新对话

导入错误

# PYTHONPATH 설정
export PYTHONPATH=/path/to/meeting-room-mcp:$PYTHONPATH

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

🤝 贡献（或参与贡献）

1. 为项目创建分支（或：克隆项目）
2. 创建你的特性分支（git checkout -b feature/AmazingFeature）
3. 提交您的更改（git commit -m 'Add some AmazingFeature')
4. 推送到分支（git push origin feature/AmazingFeature）
5. 提交一个拉取请求

📄 许可证

此项目遵循MIT许可证。

🙏 感谢信

• 模型上下文协议
• Anthropic Claude（人智派克劳德）
• 硒

📧 咨询

如有项目相关问题，请提交Issue。

______________________________________________________________________