MCP MCP 1

模型上下文协议（MCP）

构建一个客户MCP服务器，让任何AI应用程序都可以访问人工虚拟助理（AVA）的工具集。

链接

• 视频
• 博客

如何运行此示例

1. 克隆此仓库
2. 安装uv 如果你还没有

curl-LsSfhttps://astral.sh/uv/install.sh|sh

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

uv run mcp dev mcp-server-example.py

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

{
  "mcpServers": {
    "AVA": {
      "command": "wsl.exe",
      "args": [
        "/home/ayoub/.local/bin/uv",
        "--directory",
        "/home/ayoub/Personal/MCP/1/src",
        "run",
        "mcp-server-example.py"
      ]
    }
  }
}

定制AVA的行为

更新个人详细信息和首选项

1. 找到 prompts/ava.md 项目目录中的文件
2. 使用以下内容自定义文件：

- 通信偏好 - 处理任务的具体说明 - AVA的任何其他相关指南

环境设置（.env）

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

USER_EMAIL=your_email_address

# Google OAuth Credentials
GOOGLE_CREDENTIALS_PATH=.config/ava-agent/credentials.json
GOOGLE_TOKEN_PATH=.config/ava-agent/token.json

所需的环境变量：

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

Google OAuth设置

1.创建项目目录结构

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

mkdir -p .config/ava-agent

2.建立谷歌云项目

1. 转到 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用Gmail API：

- 在导航菜单中，转到“API和服务”>“库” - 搜索“Gmail API” - 点击“启用”

3.创建OAuth凭据

1. 在Google Cloud控制台中：

- 转到“API和服务”>“凭据” - 点击“创建凭据”>“OAuth客户端ID” - 选择“桌面应用程序”作为应用程序类型 - 为其命名（例如，“AVA Gmail客户端”） - 点击“创建”

1. 下载凭据：

- 创建后，单击“下载JSON” - 将下载的文件另存为 credentials.json 在 .config/ava-agent/ - 该文件应包含您的客户端ID和客户端机密

4.配置OAuth同意屏幕

1. 在Google Cloud控制台中：

- 转到“API和服务”>“OAuth同意屏幕” - 选择“外部”用户类型 - 填写所需信息： - 应用名称 - 用户支持电子邮件 - 开发人员联系信息 - 添加Gmail API范围： https://www.googleapis.com/auth/gmail.modify - 将您的电子邮件添加为测试用户 - 完成配置

登录谷歌

在服务器可以访问您的Gmail帐户之前，您需要对其进行授权。您可以通过运行 uv run oauth.py 其执行以下操作。

1. 检查是否存在 token.json
2. 如果未找到，它将启动Google OAuth身份验证流程
3. 在浏览器中指导您完成身份验证过程：

- 您将被要求登录您的Google帐户 - 授予请求的权限 - 应用程序将自动保存令牌

1. 自动生成并存储令牌

安全须知

文件保护

• 永远不要承诺你的 .env 文件或 token.json 到版本控制
• 确保您的Google凭据安全
• 将以下内容添加到您的 .gitignore:

  .env
  .config/ava-agent/token.json
  .config/ava-agent/credentials.json