Geekbot MCP

Desbloquea tus datos de Geekbot dentro de tus aplicaciones LLM 🚀

El servidor MCP (Protocolo de Contexto de Modelo) de Geekbot actúa como puente, conectando las aplicaciones cliente LLM (como Claude, Cursor, Windsurf, etc.) directamente con tu espacio de trabajo de Geekbot. Esto te permite interactuar con tus reuniones, informes y miembros del equipo de forma fluida en tus conversaciones usando lenguaje natural.

Características principales ✨

• Accede a la información de las reuniones y encuestas : enumera todas las reuniones y encuestas en tu espacio de trabajo de Geekbot. 📊

• Recuperar informes de reuniones y resultados de encuestas : obtenga informes y resultados de encuestas con filtros para reuniones específicas, usuarios o rangos de fechas. 📄

• Ver miembros del equipo : obtén una lista de los miembros con los que colaboras en Geekbot. 👥

• Publicar informes de stand-up : publica un informe de stand-up en Geekbot. 📝

Related MCP server: Notion MCP Server

Instalación 💻

Instalación mediante herrería

Para instalar Geekbot MCP como servidor remoto a través de Smithery :

npx -y @smithery/cli install @geekbot-com/geekbot-mcp --client claude

El servidor remoto se actualizará automáticamente a la última versión con cada lanzamiento.

Más información sobre la Política de Datos de Smithery

Instalación manual

Requiere Python 3.10+ y uv .

1. Instale Python 3.10+ (si aún no lo ha hecho):

   • macOS:

     brew install python@3.10

     Consulte la guía de instalación de Homebrew Python para obtener más detalles.

   • Ubuntu/Debian:

     sudo apt update
     sudo apt install python3.10

   • Windows: Descargue e instale desde Python.org .

     Consulte la guía de instalación de Python para Windows para obtener más detalles.

2. Instalar uv (si aún no lo has hecho):

   • macOS/Linux: En su terminal, ejecute el siguiente comando:

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

   • Windows: en PowerShell, ejecute el siguiente comando:

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

   (Consulte los documentos de instalación de UV para obtener más opciones).

3. Instalar/actualizar Geekbot MCP:

   • macOS/Linux: En su terminal, ejecute el siguiente comando:

     uv tool install --upgrade geekbot-mcp

   • Windows: en PowerShell, ejecute el siguiente comando:

     uv tool install --upgrade geekbot-mcp

Configuración ⚙️

Después de instalar Geekbot MCP, puede conectarlo a su aplicación de escritorio cliente LLM (por ejemplo, Claude Desktop, Cursor, Windsurf, etc.):

1. Obtén tu clave API de Geekbot: encuéntrala en tu configuración de API/Webhooks de Geekbot 🔑.

2. Encuentra la ruta del ejecutable uv :

• Linux/macOS: En su terminal, ejecute el siguiente comando:

    which uv

• Windows: en PowerShell, ejecute el siguiente comando:

    (Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'

3. Configure su aplicación de escritorio cliente LLM: cada cliente LLM que admite MCP proporciona un archivo de configuración que puede editar para agregar el servidor Geekbot MCP.

• Escritorio de Claude

• Cursor

• Windsurf

Si está utilizando un cliente LLM diferente, consulte la documentación de su cliente para saber cómo configurar el servidor MCP.

Después de localizar el archivo de configuración, edítelo para agregar el servidor Geekbot MCP:

    {
      "mcpServers": {
        "geekbot-mcp": {
          "command": "UV-PATH",
          "args": [
            "tool",
            "run",
            "geekbot-mcp"
          ],
          "env": {
            "GB_API_KEY": "YOUR-API-KEY"
          }
        }
      }
    }

Asegúrese de reemplazar:

• UV-PATH con la ruta a su ejecutable uv del paso 2

• YOUR-API-KEY con tu clave API de Geekbot del paso 1

Uso 💡

Una vez configurada, su aplicación cliente LLM tendrá acceso a las siguientes herramientas e indicaciones para interactuar con sus datos de Geekbot:

Herramientas 🛠️

list_standups

Propósito: Enumera todas las reuniones disponibles mediante tu clave API. Útil para obtener una visión general o encontrar el ID de una reunión específica.

Ejemplo de mensaje: "Oye, ¿puedes enumerar mis reuniones de Geekbot?"

Campos de datos devueltos:

• id : Identificador único de stand-up.

• name : Nombre del standup.

• channel : canal de comunicación asociado (por ejemplo, canal de Slack).

• time : Hora programada para el informe de pie.

• timezone : Zona horaria para la hora programada.

• questions : Lista de preguntas realizadas en la reunión.

• participants : Listado de usuarios que participan en el standup.

• owner_id : ID del propietario del stand-up.

• confidential : si la reunión es confidencial.

• anonymous : Si el stand-up es anónimo.

list_polls

Propósito: Enumera todas las encuestas accesibles mediante tu clave API. Útil para obtener una visión general o encontrar el ID de una encuesta específica.

Ejemplo de mensaje: "Oye, ¿puedes enumerar mis encuestas de Geekbot?"

Campos de datos devueltos:

• id : Identificador único de la encuesta.

• name : Nombre de la encuesta.

• time : Hora programada para la encuesta.

• timezone : Zona horaria para la hora programada.

• questions : Lista de preguntas realizadas en la encuesta.

• participants : Lista de usuarios que participan en la encuesta.

• creator : El creador de la encuesta.

fetch_reports

Propósito: Recupera informes específicos de reuniones. Puede filtrar por reunión, usuario y rango de fechas.

Ejemplos de indicaciones:

• "Obtener los informes enviados ayer en la Retrospectiva".

• "Muéstrame los informes del usuario John Doe para la reunión semanal de sincronización".

• Reciba todos los informes enviados a la reunión diaria después del 1 de junio de 2024.

Filtros disponibles:

• standup_id : Filtrar por un ID de standup específico.

• user_id : Filtrar informes por un ID de usuario específico.

• after : Recuperar informes enviados después de esta fecha (AAAA-MM-DD) 🗓️.

• before : Recuperar informes enviados antes de esta fecha (AAAA-MM-DD) 🗓️.

Campos de datos devueltos:

• id : Identificador único del informe.

• reporter_name : Nombre del usuario que envió el informe.

• reporter_id : ID del usuario que envió el informe.

• standup_id : ID del standup al que pertenece el informe.

• created_at : Marca de tiempo cuando se envió el informe.

• content : Las respuestas/contenido reales del informe.

post_report

Propósito: Publica un informe en Geekbot.

Ejemplo de mensaje: "Oye, ¿puedes publicar el informe de la reunión diaria?"

Campos de datos devueltos:

• id : Identificador único del informe.

• reporter_name : Nombre del usuario que envió el informe.

• reporter_id : ID del usuario que envió el informe.

• standup_id : ID del standup al que pertenece el informe.

• created_at : Marca de tiempo cuando se envió el informe.

• content : Las respuestas/contenido reales del informe.

list_members

Propósito: enumera todos los miembros del equipo con los que compartes reuniones en tu espacio de trabajo de Geekbot.

Ejemplo de mensaje: "¿Quiénes son los miembros de mi espacio de trabajo de Geekbot?"

Campos de datos devueltos:

• id : Identificador de miembro único.

• name : Nombre completo del miembro.

• email : Dirección de correo electrónico del miembro.

• role : rol del miembro dentro de Geekbot (por ejemplo, administrador, miembro).

fetch_poll_results

Propósito: Recupera resultados específicos de una encuesta. Requiere un ID de encuesta y, opcionalmente, un rango de fechas.

Ejemplo de mensaje: "Oye, ¿qué se decidió sobre el nuevo logotipo en las encuestas de Geekbot?"

Campos de datos devueltos:

• total_results : Número total de resultados.

• question_results : Lista de resultados de preguntas.

Indicaciones 💬

weekly_rollup_report

Propósito: Genera un informe acumulativo semanal completo que resume las respuestas de las reuniones del equipo, destaca las actualizaciones clave, identifica los riesgos y las estrategias de mitigación, describe los próximos pasos y realiza un seguimiento de los próximos lanzamientos.

Consejos 💡

• Revisar el uso de herramientas : Permite que el agente solicite tu aprobación explícita para cada acción de la herramienta y no permita llamadas automáticas. Esta función de seguridad te permite mantener el control sobre operaciones sensibles, especialmente al publicar informes en Geekbot. Se te solicitará que revises y apruebes cada llamada de herramienta antes de su ejecución, lo que ayuda a evitar envíos de datos no deseados.

• Solicitar vista previa : Antes de publicar un informe, pídele al agente que lo previsualice, no que lo publique. Esto te dará la oportunidad de revisarlo y asegurarte de que sea correcto o modificarlo antes de publicarlo en Geekbot.

• Limite el volumen de datos recuperados : Si utiliza la herramienta fetch_reports , limite el intervalo de fechas a un período razonable. Esto ayudará a evitar que el agente recupere una gran cantidad de datos y cause problemas de rendimiento. Tenga en cuenta que el agente aplicará límites a la cantidad de informes que puede recuperar.

Argumentos:

• standup_id : ID del standup a incluir en el informe acumulativo.

Desarrollo 🧑‍💻

¿Está interesado en contribuir o ejecutar el servidor localmente?

Configurar el entorno de desarrollo

# 1. Clone the repository
git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp

# 2. Install uv (if needed)
# curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Create a virtual environment and install dependencies
uv sync

Ejecución de pruebas ✅

# Ensure dependencies are installed (uv sync)
pytest

Contribuyendo 🤝

¡Agradecemos sus contribuciones! Por favor, bifurquen el repositorio y envíen una solicitud de incorporación de cambios.

Licencia 📜

Este proyecto está licenciado bajo la licencia MIT .

Agradecimientos 🙏

• Construido sobre el marco del Protocolo de Contexto del Modelo Antrópico .

• Aprovecha la API oficial de Geekbot .