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) 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 ✨

• Acceder a la información de las reuniones : enumera todas las reuniones en tu espacio de trabajo de Geekbot. 📊
• Recuperar informes de standup : obtenga informes con filtros para standups específicos, usuarios o rangos de fechas. 📄
• Ver miembros del equipo : obtén una lista de los miembros con los que colaboras en Geekbot. 👥

Instalación 💻

Requiere Python 3.10+ y uv .

1. Instalar uv (si aún no lo has hecho):
   curl -LsSf https://astral.sh/uv/install.sh | sh
   (Consulte los documentos de instalación de UV para obtener más opciones).
2. Instalar Geekbot MCP:
   uv tool install geekbot-mcp

Actualizando ⬆️

Para actualizar a la última versión:

Configuración ⚙️

Conecte Geekbot MCP a su LLM (por ejemplo, Claude Desktop):

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 :
   which uv
3. Configure su aplicación cliente LLM: edite su claude_desktop_config.json (o archivo de configuración equivalente para otros clientes MCP) para agregar el servidor Geekbot MCP
   { "globalShortcut": "", "mcpServers": { // Add or update this section "geekbot-mcp": { "command": "<path-returned-by-which-uv>", // Replace with your actual uv path "args": [ "tool", "run", "geekbot-mcp" ], // Environment variables needed by the server "env": { "GB_API_KEY": "<your-geekbot-api-key>" // Replace with your actual API key } } // ... other MCP servers if any } // ... other configurations }
   (Consulte la Guía de inicio rápido de MCP para obtener más detalles sobre la configuración del cliente).

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.
• 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.
• 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 único de miembro.
• 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).

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.

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

Ejecución de pruebas ✅

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 .