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"