Geekbot MCP

Geekbot MCP

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

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

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

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

Установка 💻

Установка через Smithery

Чтобы установить Geekbot MCP в качестве удаленного сервера через Smithery :

Удаленный сервер будет автоматически обновляться до последней версии с каждым выпуском.

Дополнительная информация о политике использования данных Smithery

Ручная установка

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

1. Установите Python 3.10+ (если вы еще этого не сделали):
   • macOS:
     brew install python@3.10
     Более подробную информацию смотрите в руководстве по установке Homebrew Python .
   • Убунту/Дебиан:
     sudo apt update sudo apt install python3.10
   • Windows: Загрузите и установите с Python.org .Более подробную информацию см. в руководстве по установке Python для Windows .
2. Установите uv (если вы этого еще не сделали):
   • macOS/Linux: В терминале выполните следующую команду:
     curl -LsSf https://astral.sh/uv/install.sh | sh
   • Windows: в PowerShell выполните следующую команду:
     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

   (Дополнительные параметры см. в документации по установке УФ-ламп .)

3. Установка/обновление Geekbot MCP:
   • macOS/Linux: В терминале выполните следующую команду:
     uv tool install --upgrade geekbot-mcp
   • Windows: в PowerShell выполните следующую команду:
     uv tool install --upgrade geekbot-mcp

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

После установки Geekbot MCP вы можете подключить его к своему клиентскому настольному приложению LLM (например, Claude Desktop, Cursor, Windsurf и т. д.):

1. Получите свой ключ API Geekbot: найдите его в настройках API/Webhooks Geekbot 🔑.
2. Найдите путь к исполняемому файлу uv :

• Linux/macOS: В терминале выполните следующую команду:
  which uv
• Windows: в PowerShell выполните следующую команду:
  (Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'

3. Настройте клиентское настольное приложение LLM: каждый клиент LLM, поддерживающий MCP, предоставляет файл конфигурации, который можно редактировать, чтобы добавить сервер Geekbot MCP.

• Клод Десктоп
• Курсор
• Виндсерфинг

Если вы используете другой клиент LLM, обратитесь к документации вашего клиента, чтобы узнать, как настроить сервер MCP.

После того, как вы найдете файл конфигурации, отредактируйте его, чтобы добавить сервер Geekbot MCP:

Обязательно замените:

• UV-PATH с путем к исполняемому файлу uv из шага 2
• YOUR-API-KEY с вашим ключом API Geekbot из шага 1

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

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

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

list_standups

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

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

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

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

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

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

Советы 💡

• Обзор использования инструмента : заставьте агента запрашивать ваше явное одобрение для каждого действия инструмента и не разрешайте автоматические вызовы инструментов. Эта функция безопасности гарантирует, что вы сохраните контроль над конфиденциальными операциями, особенно при отправке отчетов в Geekbot. Вам будет предложено просмотреть и одобрить каждый вызов инструмента перед выполнением, что поможет предотвратить непреднамеренную отправку данных.
• Запросить предварительный просмотр : Перед публикацией отчета попросите агента просмотреть отчет, а не публиковать его. Это даст вам возможность просмотреть отчет и убедиться в его правильности или внести в него изменения перед публикацией в Geekbot.
• Ограничьте объем извлекаемых данных : если вы используете инструмент fetch_reports , ограничьте диапазон дат разумным периодом. Это поможет предотвратить извлечение агентом большого объема данных и возникновение проблем с производительностью. Имейте в виду, что агент будет применять ограничения на количество отчетов, которые он может извлечь.

Аргументы:

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

Развитие 🧑‍💻

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

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

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

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

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

Лицензия 📜

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

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

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