Google Calendar MCP Server - คู่มือการติดตั้งและการใช้งาน
📘 ภาพรวม
Model Context Protocol (MCP) server ที่ให้บริการเข้าถึง Google Calendar API พร้อมรองรับการทำงานแบบ asynchronous operations ช่วยให้การจัดการปฏิทินมีประสิทธิภาพผ่านอินเตอร์เฟซที่เป็นมาตรฐาน
🚀 คุณสมบัติหลัก
- เชื่อมต่อกับ Google Calendar API แบบไร้รอยต่อ
- รองรับการทำงานแบบ asynchronous สำหรับประสิทธิภาพสูงสุด
- ระบบ authentication แบบ OAuth 2.0 พร้อมการต่ออายุโทเค็นอัตโนมัติ
- การจัดการข้อผิดพลาดและการล็อกแบบครอบคลุม
- อินเทอร์เฟซ MCP ที่เรียบง่ายสำหรับการใช้งานกับ Claude และ AI อื่นๆ
🔑 เครื่องมือ API
| เครื่องมือ | คำอธิบาย |
|---|---|
| list | ดึงรายการกิจกรรมในปฏิทิน (2 ปีย้อนหลังถึง 1 ปีล่วงหน้า) |
| create-event | สร้างกิจกรรมใหม่ในปฏิทิน |
| delete-duplicates | ลบกิจกรรมที่ซ้ำกัน |
| delete-event | ลบกิจกรรมที่ระบุ |
🛠️ การติดตั้ง
สิ่งที่ต้องมีก่อน
- Python 3.9 หรือสูงกว่า
- การเชื่อมต่ออินเทอร์เน็ต
- โปรเจกต์ Google Cloud Console ที่มี Google Calendar API เปิดใช้งาน
ขั้นตอนการติดตั้ง
- โคลนโปรเจกต์
git clone https://github.com/yourusername/GCalendar.git
cd GCalendar- สร้างสภาพแวดล้อมเสมือน (วิธีที่แนะนำ)
python -m venv gcalendar_venv
# สำหรับ Windows
gcalendar_venv\Scripts\activate
# สำหรับ macOS/Linux
source gcalendar_venv/bin/activate- ติดตั้งแพ็คเกจที่จำเป็น
pip install -r requirements.txt- เตรียมโฟลเดอร์ที่จำเป็น
mkdir -p credentials logsการตั้งค่า Authentication
- สร้างโปรเจกต์ Google Cloud Console
- ไปที่ Google Cloud Console - สร้างโปรเจกต์ใหม่ - เปิดใช้งาน Google Calendar API - สร้าง OAuth 2.0 Client ID - ดาวน์โหลด credentials.json ไปที่โฟลเดอร์ credentials/
- สร้างโทเค็น
python src/create_token.py- ทำตามขั้นตอนในเบราว์เซอร์เพื่อให้สิทธิ์การเข้าถึง - โทเค็นจะถูกบันทึกในโฟลเดอร์ credentials/ เป็น token.json
⚙️ การกำหนดค่าเทคนิค
การกำหนดค่า MCP Server
เพิ่มในไฟล์ claude_desktop_config.json:
{
"mcpServers": {
"gcalendar": {
"command": "YOUR_PYTHON_PATH",
"args": [
"YOUR_PATH/GCalendar/src/mcp_server.py"
]
}
}
}แทนที่ตัวยึดตำแหน่ง:
YOUR_PYTHON_PATH: พาธไปยัง Python interpreter (จาก venv หรือ conda)YOUR_PATH: พาธเต็มไปยังโฟลเดอร์ที่โคลน
โครงสร้างโปรเจกต์
GCalendar/
├── credentials/
│ ├── credentials.json # จาก Google Cloud Console
│ └── token.json # สร้างโดย create_token.py
├── logs/
│ └── calendar_service.log
├── src/
│ ├── calendar_service.py # การดำเนินการปฏิทินหลัก
│ ├── create_token.py # การสร้างโทเค็น
│ ├── list_past_events.py # ยูทิลิตี้การแสดงรายการกิจกรรม
│ ├── mcp_client.py # การใช้งาน MCP client
│ ├── mcp_server.py # การใช้งานเซิร์ฟเวอร์หลัก
│ └── renew_token.py # ยูทิลิตี้การต่ออายุโทเค็น
├── requirements.txt
└── README.md📋 การใช้งาน
การเริ่มใช้งานเซิร์ฟเวอร์
- เริ่มเซิร์ฟเวอร์ด้วยตนเอง
python src/mcp_server.py- การใช้งานกับ Claude Desktop
- กำหนดค่าตามที่อธิบายในส่วนการกำหนดค่าข้างต้น - Claude จะเริ่มใช้งานเซิร์ฟเวอร์โดยอัตโนมัติเมื่อจำเป็น
ตัวอย่างคำสั่ง
- ดูรายการกิจกรรมในปฏิทิน
แสดงกิจกรรมในปฏิทินของฉัน- สร้างกิจกรรมใหม่
สร้างการประชุมชื่อ "ประชุมทีม" วันที่ 25 มีนาคม 2025 เวลา 14:00 น. ถึง 15:00 น.- ลบกิจกรรมที่ซ้ำกัน
ลบกิจกรรม "ประชุมทีม" ที่ซ้ำกันในวันที่ 25 มีนาคม 2025🔍 การแก้ไขปัญหา
ปัญหาการรับรองความถูกต้อง
- ตรวจสอบว่าไฟล์ credentials.json และ token.json อยู่ในโฟลเดอร์ credentials/
- ลบ token.json และสร้างใหม่โดยใช้ create_token.py
ปัญหาเกี่ยวกับเขตเวลา
- ตรวจสอบว่าไลบรารี timezone ถูกติดตั้งแล้ว:
pip install pytz tzdataการตรวจสอบล็อก
- ดูไฟล์ล็อกเพื่อรับข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาด:
cat logs/calendar_service.log📚 การพึ่งพา
- google-auth-oauthlib==1.0.0
- google-auth-httplib2==0.1.0
- google-api-python-client==2.108.0
- aiohttp==3.8.5
- asyncio==3.4.3
- pytz==2023.3
- tzdata==2023.3
📄 ใบอนุญาต
โปรเจกต์นี้มีใบอนุญาตภายใต้ MIT License ดูไฟล์ LICENSE สำหรับรายละเอียด "# py-mcp-gcalendar"