Geekbot MCP

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

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

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

• Доступ к информации о стендапах и опросах : список всех стендапов и опросов в вашем рабочем пространстве Geekbot. 📊

• Извлечение отчетов о стендапах и результатов опросов : извлечение отчетов и результатов опросов с помощью фильтров по определенным стендапам, пользователям или диапазонам дат. 📄

• Просмотр участников команды : получите список участников, с которыми вы сотрудничаете в Geekbot. 👥

• Публикуйте стендап-отчеты : публикуйте стендап-отчеты на Geekbot. 📝

Related MCP server: Notion MCP Server

Установка 💻

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

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

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

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

Дополнительная информация о политике использования данных 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:

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

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

• 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 : идентификатор стендапа, включаемого в сводный отчет.

Развитие 🧑‍💻

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

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

# 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

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

# Ensure dependencies are installed (uv sync)
pytest

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

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

Лицензия 📜

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

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

• Создан на основе протокола контекста антропной модели .

• Использует официальный API Geekbot .