个人日程管理代理

个人代理人

这个项目是一个个人代理，可以帮助你完成日常任务。它是用Python构建的，并使用Google日历API来管理您的日历。代理通过FastAPI服务器作为一组工具公开，可供其他应用程序使用。

特性

• 谷歌日历管理：列出、创建和删除日历。
• 谷歌日历事件管理：列出、创建、更新和删除事件。
• RESTful API：所有功能都通过使用FastAPI构建的RESTful API公开。
• 配置管理：使用YAML文件便于配置。
• 日志记录：集中记录所有重要事件。

入门指南

先决条件

• Python 3.12
• 紫外线：一个快速的Python包安装程序。如果你没有它，你可以访问安装它 https://docs.astral.sh/uv/getting-started/installation/#installation-methods.
• Google账户：在您的Google Cloud项目中启用日历API的活动Google帐户。

安装和设置

1. 克隆存储库：

   复制

   git clone https://github.com/PoorneshShiva/Personal-MCP-Agent
   cd mcp_agent
   

2. 创建虚拟环境并安装依赖项： 此命令创建虚拟环境并将其与中指定的依赖项同步 pyproject.toml.

   复制

   uv sync
   

3. 激活虚拟环境：

   复制

   # Activate on Linux or macOS
   source .venv/bin/activate
   

   复制

   # Activate on Windows (Command Prompt or PowerShell)
   .\.venv\Scripts\activate
   

4. 以可编辑模式安装项目： 这使得 start_mcp 命令在shell中可用。

   复制

   uv pip install -e .
   

5. 配置应用程序：

   • 谷歌凭据：确保您的 gcp-oauth.keys.json 文件位于项目的根目录中。此文件包含访问Google Calandar API所需的凭据。
   • 配置文件：评论 config.yaml 以确保 port 和 logging 设置适合您的环境。

6. 运行服务器： 执行 start_mcp 启动服务器的命令。

   复制

   start_mcp
   

   服务器将在您的 config.yaml.

测试

此项目包括一个全面的测试脚本，用于验证所有代理工具是否正常运行。

要运行测试，请从根目录执行以下命令：

python test_codes/test_all_tools.py

未来范围

• Google表格、驱动器和文档集成
• 支持更多谷歌服务，如Gmail和Keep
• 自然语言接口

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。