Geekbot MCP

Geekbot MCP

Разблокируйте данные Geekbot в своих приложениях LLM 🚀

Сервер Geekbot MCP (Model Context Protocol) действует как мост, соединяя клиентские приложения LLM (например, Claude) напрямую с вашим рабочим пространством Geekbot. Это позволяет вам беспрепятственно взаимодействовать с вашими стендапами, отчетами и членами команды в ваших разговорах, используя естественный язык.

Основные характеристики ✨

• Доступ к информации о стендапах : список всех стендапов в вашем рабочем пространстве Geekbot. 📊
• Извлечение отчетов о стендапах : извлечение отчетов с фильтрами по определенным стендапам, пользователям или диапазонам дат. 📄
• Просмотр участников команды : получите список участников, с которыми вы сотрудничаете в Geekbot. 👥

Установка 💻

Требуется Python 3.10+ и uv .

1. Установите uv (если вы этого еще не сделали):
   curl -LsSf https://astral.sh/uv/install.sh | sh
   (Дополнительные параметры см. в документации по установке УФ-ламп .)
2. Установите Geekbot MCP:
   uv tool install geekbot-mcp

Обновление ⬆️

Для обновления до последней версии:

Конфигурация ⚙️

Подключите Geekbot MCP к вашему LLM (например, Claude Desktop):

1. Получите свой ключ API Geekbot: найдите его в настройках API/Webhooks Geekbot 🔑.
2. Найдите путь к исполняемому файлу uv :
   which uv
3. Настройте клиентское приложение LLM: отредактируйте файл claude_desktop_config.json (или эквивалентный файл конфигурации для других клиентов MCP), чтобы добавить сервер 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 }
   (Более подробную информацию о настройке клиента см. в кратком руководстве MCP .)

Использование 💡

После настройки ваше клиентское приложение LLM получит доступ к следующим инструментам и подсказкам для взаимодействия с данными Geekbot:

Инструменты 🛠️

• list_standups

Назначение: Перечисляет все стендапы, доступные через ваш ключ API. Полезно для получения обзора или поиска определенного идентификатора стендапа.

Пример запроса: «Эй, можешь перечислить мои стендапы Geekbot?»

Возвращаемые поля данных:

• id : Уникальный идентификатор стендапа.
• name : Название выступления.
• channel : связанный канал связи (например, канал Slack).
• time : Запланированное время для стендап-отчета.
• timezone : часовой пояс для запланированного времени.
• questions : Список вопросов, заданных в ходе выступления.
• participants : Список пользователей, участвующих в стендапе.
• owner_id : идентификатор владельца стендапа.
• list_polls

Назначение: Перечисляет все опросы, доступные через ваш ключ API. Полезно для получения обзора или поиска определенного идентификатора опроса.

Пример запроса: «Эй, можешь перечислить мои опросы Geekbot?»

Возвращаемые поля данных:

• id : Уникальный идентификатор опроса.
• name : Название опроса.
• time : Запланированное время для опроса.
• timezone : часовой пояс для запланированного времени.
• questions : Список вопросов, заданных в опросе.
• participants : Список пользователей, участвующих в опросе.
• creator : Создатель опроса.
• fetch_reports

Назначение: Извлекает определенные отчеты о стендапах. Вы можете фильтровать по стендапу, пользователю и диапазону дат.

Примеры подсказок:

• «Загрузить отчеты, представленные вчера в ретроспективе».
• «Покажите мне отчеты пользователя Джона Доу для стендапа «Weekly Sync».
• «Получите все отчеты, отправленные в Daily Standup после 1 июня 2024 года».

Доступные фильтры:

• standup_id : Фильтрация по определенному идентификатору стендапа.
• user_id : Фильтрация отчетов по определенному идентификатору пользователя.
• after : Получить отчеты, отправленные после этой даты (ГГГГ-ММ-ДД) 🗓️.
• before : Получить отчеты, отправленные до указанной даты (ГГГГ-ММ-ДД) 🗓️.

Возвращаемые поля данных:

• id : Уникальный идентификатор отчета.
• reporter_name : Имя пользователя, отправившего отчет.
• reporter_id : идентификатор пользователя, отправившего отчет.
• standup_id : идентификатор стендапа, к которому относится отчет.
• created_at : временная метка отправки отчета.
• content : Фактические ответы/содержание отчета.
• post_report

Цель: Публикация отчета в Geekbot.

Пример запроса: «Эй, можешь опубликовать отчет о стендапе Daily Standup?»

Возвращаемые поля данных:

• id : Уникальный идентификатор отчета.
• reporter_name : Имя пользователя, отправившего отчет.
• reporter_id : идентификатор пользователя, отправившего отчет.
• standup_id : идентификатор стендапа, к которому относится отчет.
• created_at : временная метка отправки отчета.
• content : Фактические ответы/содержание отчета.
• list_members

Назначение: Составляет список всех членов команды, с которыми вы делитесь стендапами в вашем рабочем пространстве Geekbot.

Пример запроса: «Кто является участниками моего рабочего пространства Geekbot?»

Возвращаемые поля данных:

• id : Уникальный идентификатор участника.
• name : Полное имя участника.
• email : адрес электронной почты участника.
• role : Роль участника в Geekbot (например, Администратор, Участник).
• fetch_poll_results

Назначение: Извлекает конкретные результаты опроса. Требуется идентификатор опроса и, опционально, диапазон дат.

Пример вопроса: «Эй, какое решение было принято по поводу нового логотипа в опросах Geekbot?»

Возвращаемые поля данных:

• total_results : Общее количество результатов.
• question_results : Список результатов вопросов.

Подсказки 💬

• weekly_rollup_report

Цель: создание комплексного еженедельного сводного отчета, в котором обобщаются ответы команды на стычках, освещаются ключевые обновления, определяются риски и стратегии их смягчения, излагаются дальнейшие шаги и отслеживаются предстоящие запуски.

Аргументы:

• standup_id : идентификатор стендапа, включаемого в сводный отчет.

Развитие 🧑‍💻

Хотите внести свой вклад или запустить сервер локально?

Настройка среды разработки

Проведение тестов ✅

Вношу свой вклад 🤝

Вклады приветствуются! Пожалуйста, сделайте форк репозитория и отправьте запрос на извлечение с вашими изменениями.

Лицензия 📜

Данный проект лицензирован в соответствии с лицензией MIT .

Благодарности 🙏

• Создан на основе протокола контекста антропной модели .
• Использует официальный API Geekbot .