MCP Pa Ai Agent

🚀 MCP 個人助理代理

MCP 個人助理代理是一個功能強大的個人助理 AI 工具，它基於 Model Context Protocol (MCP) 構建，能夠幫助用戶高效管理日曆、任務、電子郵件等日常事務，提升工作和生活效率。

🚀 快速開始

該項目是一個基於 MCP 協議的服務器，提供了一系列工具，用於構建一個個人助理代理。它可以與像 Claude for Desktop 這樣的 MCP 客戶端集成，賦予 AI 助手管理日曆、任務、郵件、搜索網絡和控制智能家居等能力。

✨ 主要特性

• 管理日曆事件
• 跟蹤任務和待辦事項
• 閱讀和發送電子郵件
• 搜索網絡並檢索信息
• 控制智能家庭設備

📦 安裝指南

⚠️ 重要提示

MCP SDK 需要 Python 3.10 或更高版本。舊版本的 Python 不會工作。

前提條件

• Python 3.10+
• MCP SDK 1.2.0+
• 必要的 Python 包（見 requirements.txt）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/mcp-pa-ai-agent.git
cd mcp-pa-ai-agent

2. 確保你使用的是 Python 3.10+：

python --version

3. 如果系統 Python 版本低於 3.10，設置兼容環境：

# 使用 conda
conda create -n mcp-env python=3.10
conda activate mcp-env

# 或者使用 venv（如果其他地方安裝了 Python 3.10+）
python3.10 -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

4. 安裝依賴項：

pip install -r requirements.txt

5. 複製示例環境變量文件：

cp .env.example .env

6. 根據需要編輯 .env 文件，配置 API 憑證和設置。

💻 使用示例

運行服務器

運行 MCP 服務器：

python mcp_server.py

服務器啟動並監聽 MCP 客戶端連接。

連接到 Claude for Desktop

1. 安裝 Claude for Desktop
2. 配置 Claude for Desktop 使用此 MCP 服務器，編輯配置文件：
   • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 添加以下配置：

{
  "mcpServers": {
    "personal-assistant": {
      "command": "/path/to/python",
      "args": [
        "/absolute/path/to/mcp-pa-ai-agent/mcp_server.py"
      ]
    }
  }
}

如果你使用的是虛擬環境，請確保指向該環境中的 Python 可執行文件。 4. 重啟 Claude for Desktop

📚 詳細文檔

可用工具

日曆

• get_events：檢索即將進行的日曆事件
• create_event：安排新的日曆事件

任務

• list_tasks：查看所有任務或按狀態篩選
• add_task：創建新任務
• update_task_status：將任務標記為待處理、進行中或完成

電子郵件

• get_emails：列出收件箱中的近期電子郵件
• read_email：查看特定電子郵件的全文內容
• send_email：撰寫併發送新的電子郵件

知識庫

• web_search：在網絡上搜索信息
• get_weather：獲取當前天氣信息
• get_news：檢索最新新聞文章

智能家庭

• list_devices：查看所有智能家庭設備
• control_device：控制智能家庭設備（燈、恆溫器等）
• get_device_state：獲取設備當前狀態的詳細信息