MCP Personal Assistant Agent

基本能力

产品定位

MCP Personal Assistant Agent 是一个基于 Model Context Protocol (MCP) 构建的多功能个人助理 AI 代理，主要用于管理日历、任务、电子邮件等日常事务，并能与智能家居设备交互。

核心功能

• 日历管理：检索即将到来的日历事件，安排新事件
• 任务管理：查看所有任务或按状态筛选，创建新任务，更新任务状态
• 电子邮件：列出最近的电子邮件，查看特定邮件的完整内容，撰写和发送新邮件
• 知识检索：搜索网络信息，获取当前天气信息，检索最新新闻文章
• 智能家居控制：查看所有智能家居设备，控制设备（灯光、恒温器等），获取设备当前状态的详细信息

适用场景

• 个人日程管理
• 任务跟踪和提醒
• 电子邮件管理
• 智能家居控制
• 信息检索（天气、新闻等）

工具列表

• Calendar
• get_events: 检索即将到来的日历事件
• create_event: 安排新日历事件
• Tasks
• list_tasks: 查看所有任务或按状态筛选
• add_task: 创建新任务
• update_task_status: 将任务标记为待处理、进行中或已完成
• Email
• get_emails: 列出收件箱中的最近邮件
• read_email: 查看特定邮件的完整内容
• send_email: 撰写和发送新邮件
• Knowledge
• web_search: 搜索网络信息
• get_weather: 获取当前天气信息
• get_news: 检索最新新闻文章
• Smart Home
• list_devices: 查看所有智能家居设备
• control_device: 控制智能家居设备（灯光、恒温器等）
• get_device_state: 获取设备当前状态的详细信息

常见问题解答

• Python 版本问题：如果出现错误提示需要 Python 3.10 或更高版本，请升级 Python 版本或使用 Python 3.10+ 的虚拟环境。
• MCP SDK 安装问题：如果安装 MCP SDK 时出现问题，请确保使用 Python 3.10+ 并更新 pip。

使用教程

使用依赖

• 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

1. 确保安装 Python 3.10+：

python --version

1. 如果系统 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

1. 安装依赖：

pip install -r requirements.txt

1. 配置环境变量：

cp .env.example .env

1. 编辑 .env 文件，填写 API 凭据和设置。

调试方式

启动 MCP 服务器：

python mcp_server.py

服务器将启动并监听 MCP 客户端连接。

连接到 Claude for Desktop

1. 安装 Claude for Desktop
2. 配置 Claude for Desktop 使用此 MCP 服务器，编辑配置文件：
3. MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
4. Windows: %APPDATA%\Claude\claude_desktop_config.json
5. 添加以下配置：

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

1. 重启 Claude for Desktop

许可证

该项目遵循 MIT 开源许可条款。