个人代理人
这个项目是一个个人代理,可以帮助你完成日常任务。它是用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 Cloud项目中启用日历API的活动Google帐户。
安装和设置
- 克隆存储库:
git clone https://github.com/PoorneshShiva/Personal-MCP-Agent
cd mcp_agent- 创建虚拟环境并安装依赖项:
此命令创建虚拟环境并将其与中指定的依赖项同步 pyproject.toml.
uv sync- 激活虚拟环境:
# Activate on Linux or macOS
source .venv/bin/activate # Activate on Windows (Command Prompt or PowerShell)
.\.venv\Scripts\activate- 以可编辑模式安装项目:
这使得 start_mcp 命令在shell中可用。
uv pip install -e .- 配置应用程序:
- 谷歌凭据:确保您的 gcp-oauth.keys.json 文件位于项目的根目录中。此文件包含访问Google Calandar API所需的凭据。 - 配置文件:评论 config.yaml 以确保 port 和 logging 设置适合您的环境。
- 运行服务器:
执行 start_mcp 启动服务器的命令。
start_mcp服务器将在您的 config.yaml.
测试
此项目包括一个全面的测试脚本,用于验证所有代理工具是否正常运行。
要运行测试,请从根目录执行以下命令:
python test_codes/test_all_tools.py未来范围
- Google表格、驱动器和文档集成
- 支持更多谷歌服务,如Gmail和Keep
- 自然语言接口
许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。
