Attendee MCP Server

Un servidor MCP para gestionar bots de reuniones de Attendee, que requiere un servicio backend de Attendee en ejecución.

Documentación

Servidor MCP de Attendee

Este es un MCP para enviar y gestionar bots de reuniones con Attendee, un bot de reuniones de código abierto para grabación y transcripción. Puedes ejecutar Attendee localmente o desplegarlo en la nube.

¿Preguntas? Únete al Slack de Attendee.

Attendee Server MCP server

Inicio rápido: ¿Qué puedes hacer con este MCP?

Usando Claude como ejemplo: puedes escribir lo siguiente y empezar a trabajar con un bot de reuniones de IA.

  1. "Envía un bot a esta reunión: <meeting_url>"
  2. "Haz que el bot diga 'Hola'", y el bot diría 'Hola' en la reunión.
  3. "Haz que el bot envíe un mensaje de chat: 'Me alegra estar aquí'", y el bot escribiría 'Me alegra estar aquí' en el chat.
  4. "Haz que el bot abandone la reunión"

Claude Bot

Combinando MCPs

Combinar MCPs conduce a flujos de trabajo potentes. Por ejemplo, uso el MCP de Brave Search junto con el MCP de Attendee. Cuando le pregunto a Claude: "¿Quién ganó el último torneo de Roland Garros?", este:

  1. Usa el MCP web para encontrar la respuesta en línea.
  2. Envía el resultado al bot de Attendee, que me responde hablando.

🚀 Instalación

Usaremos Claude como ejemplo, pero puedes usar cualquier herramienta compatible con MCPs.

Clonar el repositorio

# Clone your fork or the main repo
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

# Link for global use
npm link

⚙️ Configuración

Variables de entorno

Configura estas variables de entorno para tu servidor de Attendee:

export MEETING_BOT_API_URL="http://localhost:8000"  # Your Attendee server URL
export MEETING_BOT_API_KEY="your-api-key-here"     # Your Attendee API key

Agrégalas a tu perfil de shell (~/.zshrc, ~/.bashrc, etc.) para hacerlas permanentes.

Configuración de Claude Desktop

Actualiza tu archivo de configuración de Claude Desktop en: ~/Library/Application Support/Claude/claude_desktop_config.json. Después de hacer los cambios, reinicia Claude.

Ajusta la sección mcpServers para incluir el servidor MCP de Attendee. Usa la ruta directa por ahora, ya que ha demostrado ser la más confiable.

{
  "mcpServers": {
    "attendee": {
      "command": "node",
      "args": [
        "<path>/attendee-mcp/dist/index.js"
      ],
      "env": {
        "MEETING_BOT_API_URL": "<attendee-url-here>",
        "MEETING_BOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reemplaza /path/to/attendee-mcp con la ruta real donde clonaste el repositorio.

🏃‍♂️ Inicio rápido si quieres ejecutar Attendee localmente

  1. Inicia tu servidor de Attendee:
    make build
    make up
    
  2. Prueba en Claude Desktop:
    • Pregunta a Claude: "¿Qué herramientas MCP están disponibles?"

🎯 Ejemplos de uso

Una vez configurado, puedes usar comandos en lenguaje natural en Claude Desktop:

Crear bots de reuniones

Gestionar bots

  • "¿Cuál es el estado del bot bot_abc123?"
  • "Elimina el bot bot_abc123 de la reunión"

🔧 Herramientas MCP disponibles

Este servidor proporciona las siguientes herramientas:

Gestión principal de bots

  • create_meeting_bot - Crea un bot para unirse y grabar una reunión
  • get_bot_status - Verifica el estado actual de un bot de reunión
  • remove_meeting_bot - Elimina un bot de una reunión

Comunicación y medios

  • make_bot_speak - Haz que el bot hable usando texto a voz
  • send_chat_message - Envía mensajes de chat desde el bot
  • send_image_to_meeting - Muestra imágenes a través del bot (solo Google Meet)
  • send_video_to_meeting - Reproduce videos a través del bot (solo Google Meet)

Recuperación de datos

  • get_meeting_transcript - Recupera la transcripción de la reunión
  • get_chat_messages - Obtén los mensajes de chat de la reunión
  • get_recording - Obtén la URL de descarga de la grabación
  • delete_bot_data - Elimina permanentemente todos los datos del bot

🐛 Solución de problemas

Problemas comunes

  1. "Error de red" o problemas de conexión con la API:

    • Asegúrate de que tu servidor de Attendee esté ejecutándose en la URL configurada
    • Verifica que tu clave de API sea correcta
    • Comprueba las variables de entorno MEETING_BOT_API_URL y MEETING_BOT_API_KEY
  2. El servidor MCP no aparece en Claude Desktop:

    • Reinicia Claude Desktop por completo después de los cambios de configuración
    • Verifica que la sintaxis del archivo de configuración de Claude Desktop sea JSON válido
    • Revisa los registros de Claude Desktop para ver mensajes de error
  3. Errores de "Método no permitido":

    • Algunos endpoints de la API podrían no estar completamente implementados en tu servidor de Attendee
    • Revisa los registros de tu servidor de Attendee para más detalles

📄 Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

🤝 Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad: git checkout -b feature-name
  3. Realiza tus cambios y pruébalos
  4. Confirma tus cambios: git commit -m 'Add feature'
  5. Sube la rama: git push origin feature-name
  6. Envía una solicitud de extracción (pull request)

🔗 Proyectos relacionados


Nota: Este servidor MCP requiere un servicio backend de Attendee en ejecución. Asegúrate de tener el servidor de Attendee configurado y ejecutándose antes de usar este servidor MCP.