AVA MCP Server

模型上下文协议（MCP）

所有版权归于： https://github.com/ShawhinT/YouTube-Blog/

这是 AI 代理系列的第四个示例。在这里，我构建了一个客户端 MCP 服务器，以便任何 AI 应用都可以访问人工智能虚拟助手 (AVA) 的工具集。

链接

• 视频
• 博客

如何运行此示例

1. 克隆此 repo
2. 如果还没有安装uv，请先安装

3. 在开发模式下测试服务器

4. 将服务器配置添加到 AI 应用程序（例如 Claude Desktop 或 Cursor）。

自定义 AVA 的行为

更新个人信息和偏好

1. 在项目目录中找到prompts/ava.md文件
2. 使用以下方式自定义文件：
   • 沟通偏好
   • 处理任务的具体说明
   • AVA 的任何其他相关指南

环境设置（.env）

1. 在项目根目录中创建一个.env文件，其中包含以下变量：

所需的环境变量：

• USER_EMAIL ：您要用于此应用程序的 Gmail 地址
• GOOGLE_CREDENTIALS_PATH ：您的 Google OAuth 凭据文件的路径
• GOOGLE_TOKEN_PATH ：存储 Google OAuth 令牌的路径

Google OAuth 设置

1.创建项目目录结构

首先，创建所需的目录结构：

2. 设置 Google Cloud 项目

1. 前往Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 Gmail API：
   • 在导航菜单中，转到“API 和服务”>“库”
   • 搜索“Gmail API”
   • 点击“启用”

3.创建OAuth凭证

1. 在 Google Cloud Console 中：
   • 前往“API 和服务”>“凭证”
   • 点击“创建凭证”>“OAuth 客户端 ID”
   • 选择“桌面应用程序”作为应用程序类型
   • 给它起一个名字（例如，“AVA Gmail 客户端”）
   • 点击“创建”
2. 下载凭证：
   • 创建完成后，点击“下载JSON”
   • 将下载的文件保存为.config/ava-agent/中的credentials.json
   • 该文件应包含您的客户端 ID 和客户端密钥

4. 配置 OAuth 同意屏幕

1. 在 Google Cloud Console 中：
   • 前往“API 和服务”>“OAuth 同意屏幕”
   • 选择“外部”用户类型
   • 填写所需信息：
     • 应用程序名称
     • 用户支持电子邮件
     • 开发者联系信息
   • 添加 Gmail API 范围： https://www.googleapis.com/auth/gmail.modify
   • 将您的电子邮件添加为测试用户
   • 完成配置

登录 Google

在服务器访问你的 Gmail 账户之前，你需要先授权。你可以运行uv run oauth.py来执行此操作，它会执行以下操作。

1. 检查token.json是否存在
2. 如果未找到，它将启动 Google OAuth 身份验证流程
3. 指导您完成浏览器中的身份验证过程：
   • 系统会要求您登录 Google 帐户
   • 授予请求的权限
   • 应用程序将自动保存令牌
4. 自动生成并存储令牌

安全说明

文件保护

• 切勿将.env文件或token.json提交到版本控制
• 确保您的 Google 凭据安全
• 将以下内容添加到您的.gitignore中：
  .env .config/ava-agent/token.json .config/ava-agent/credentials.json