Protocolo de Contexto Modelo (MCP)

Todos los créditos a: https://github.com/ShawhinT/YouTube-Blog/

Cuarto ejemplo de la serie de agentes de IA. Aquí, construyo un servidor MCP de cliente para que cualquier aplicación de IA tenga acceso a un conjunto de herramientas para un Asistente Virtual Artificial (AVA).

Campo de golf

• Video

• Blog

Cómo ejecutar este ejemplo

1. Clonar este repositorio

2. Instala uv si aún no lo has hecho

# Mac/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Pruebe el servidor en modo de desarrollo

uv run mcp dev mcp-server-example.py

4. Agregue la configuración del servidor a la aplicación AI (por ejemplo, Claude Desktop o Cursor).

{
  "mcpServers": {
    "AVA": {
      "command": "/Users/shawhin/.local/bin/uv", # replace with global path to your uv installation
      "args": [
        "--directory",
        "/Users/shawhin/Documents/_code/_stv/sandbox/ava-mcp/", # replace with global path to repo
        "run",
        "mcp-server-example.py"
      ]
    }
  }
}

Related MCP server: Gmail AutoAuth MCP Server

Personalizar el comportamiento de AVA

Actualizar datos personales y preferencias

1. Localice el archivo prompts/ava.md en el directorio de su proyecto

2. Personaliza el archivo con:

   • Preferencias de comunicación

   • Instrucciones específicas para el manejo de tareas

   • ¿Alguna otra directriz relevante para AVA?

Configuración del entorno (.env)

1. Cree un archivo .env en el directorio raíz del proyecto con las siguientes variables:

USER_EMAIL=your_email_address

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

Variables de entorno requeridas:

• USER_EMAIL : La dirección de Gmail que desea utilizar para esta aplicación

• GOOGLE_CREDENTIALS_PATH : Ruta a su archivo de credenciales de Google OAuth

• GOOGLE_TOKEN_PATH : Ruta donde se almacenará el token OAuth de Google

Configuración de Google OAuth

1. Crear la estructura del directorio del proyecto

Primero, cree la estructura de directorio requerida:

mkdir -p .config/ava-agent

2. Configurar el proyecto de Google Cloud

1. Vaya a la consola de Google Cloud

2. Crea un nuevo proyecto o selecciona uno existente

3. Habilitar la API de Gmail:

   • En el menú de navegación, vaya a "API y servicios" > "Biblioteca".

   • Buscar "API de Gmail"

   • Haga clic en "Habilitar"

3. Crear credenciales OAuth

1. En la consola de Google Cloud:

   • Vaya a "API y servicios" > "Credenciales".

   • Haga clic en "Crear credenciales" > "ID de cliente OAuth".

   • Elija "Aplicación de escritorio" como tipo de aplicación

   • Asígnele un nombre (por ejemplo, "Cliente de Gmail AVA")

   • Haga clic en "Crear"

2. Descargar las credenciales:

   • Después de la creación, haga clic en "Descargar JSON".

   • Guarde el archivo descargado como credentials.json en .config/ava-agent/

   • El archivo debe contener su ID de cliente y su secreto de cliente.

4. Configurar la pantalla de consentimiento de OAuth

1. En la consola de Google Cloud:

   • Vaya a "API y servicios" > "Pantalla de consentimiento de OAuth".

   • Seleccione el tipo de usuario "Externo"

   • Complete la información requerida:

     • Nombre de la aplicación

     • Correo electrónico de soporte al usuario

     • Información de contacto del desarrollador

   • Agregue el alcance de la API de Gmail: https://www.googleapis.com/auth/gmail.modify

   • Añade tu correo electrónico como usuario de prueba

   • Completar la configuración

Iniciar sesión en Google

Para que el servidor pueda acceder a tu cuenta de Gmail, deberás autorizarla. Puedes hacerlo ejecutando uv run oauth.py que realiza lo siguiente.

1. Verificar la presencia de token.json

2. Si no se encuentra, se iniciará el flujo de autenticación de Google OAuth.

3. Le guiaremos a través del proceso de autenticación en su navegador:

   • Se le pedirá que inicie sesión en su cuenta de Google.

   • Conceder los permisos solicitados

   • La aplicación guardará automáticamente el token.

4. Generar y almacenar el token automáticamente

Notas de seguridad

Protección de archivos

• Nunca envíe su archivo .env o token.json al control de versiones

• Mantenga sus credenciales de Google seguras

• Añade lo siguiente a tu .gitignore :

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