JinDaGe - mcp-pa-ai-agent MCP Details

article

README

🚀 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）

安装步骤

克隆仓库：

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

确保你使用的是 Python 3.10+：

python --version

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

安装依赖项：

pip install -r requirements.txt

复制示例环境变量文件：

cp .env.example .env

根据需要编辑 .env 文件，配置 API 凭证和设置。

💻 使用示例

运行服务器

运行 MCP 服务器：

python mcp_server.py

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

连接到 Claude for Desktop

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

{
  "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：获取设备当前状态的详细信息

mcp-pa-ai-agent