Сервер MCP Plane

Сервер Model Context Protocol (MCP), который позволяет LLM взаимодействовать с Plane.so , позволяя им управлять проектами и проблемами через API Plane. Используя этот сервер, LLM, такие как Клод, могут напрямую взаимодействовать с вашими рабочими процессами управления проектами, сохраняя при этом контроль и безопасность пользователя.

Функции

• Перечислите все проекты в вашем рабочем пространстве Plane

• Получите подробную информацию о конкретных проектах

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

• Список и фильтрация проблем из проектов

• Получите подробную информацию о конкретных проблемах

• Обновите существующие выпуски, добавив новую информацию

Предпосылки

• Node.js 22.x или выше

• API-ключ Plane.so

• Рабочее пространство Plane.so

Установка

Вариант 1: Использование кузнечного дела

Самый быстрый способ начать работу — использовать Smithery для непосредственной установки сервера:

Эта команда автоматически настроит сервер Plane MCP для использования с Claude. После установки вам нужно будет настроить сервер с помощью ключа API Plane и слага рабочей области через настройки Claude.

Допустимые параметры клиента: claude, cline, windsurf, roo-cline, witsy, enconvo, cursor

Пример установки с помощью курсора:

Вариант 2: Ручная настройка

Если вы предпочитаете настроить сервер вручную, выполните следующие действия:

1. Клонируйте этот репозиторий:

2. Установите зависимости:

3. Сборка сервера:

Использование с Claude для рабочего стола

Примечание: Если вы использовали вариант 1 (Smithery) выше, вы можете пропустить этот раздел. Smithery автоматически настраивает сервер MCP для вас.

1. Откройте файл конфигурации Claude for Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте конфигурацию сервера Plane MCP:

3. Перезапустить Клода для рабочего стола

Доступные инструменты

Примечание: Имена инструментов используют дефисы (например, list-projects ), а не подчеркивания. Сервер автоматически преобразует подчеркивания в дефисы для совместимости.

список-проекты

Перечисляет все проекты в вашем рабочем пространстве Plane.

Параметры: Нет

Пример:

получить-проект

Получает подробную информацию о конкретном проекте.

Параметры:

• project_id : идентификатор проекта для извлечения

Пример:

создать-выпуск

Создает новую проблему в указанном проекте.

Параметры:

• project_id : идентификатор проекта, в котором должна быть создана проблема

• name : Название выпуска

• description_html : HTML-описание проблемы (требуется для API Plane)

• priority (необязательно): Приоритет вопроса («срочный», «высокий», «средний», «низкий», «нет»)

• state_id (необязательно): идентификатор штата для этой проблемы

• assignees (необязательно): массив идентификаторов пользователей, назначаемых для этой проблемы

Примечание: Параметр assignees должен быть массивом строк идентификатора пользователя. Распространенные ошибки включают предоставление словаря/объекта вместо массива или случайное вложение всех данных о проблеме в поле assignees. Сервер попытается обработать эти случаи, но лучше использовать правильный формат.

Пример:

список-вопросов

Перечисляет проблемы из указанного проекта с возможностью фильтрации.

Параметры:

• project_id : идентификатор проекта, из которого нужно получить проблемы

• state_id (необязательно): Фильтр по идентификатору штата

• priority (необязательно): Фильтр по приоритету

• assignee_id (необязательно): Фильтр по идентификатору получателя

• limit (необязательно): максимальное количество возвращаемых проблем (по умолчанию: 50)

Пример:

получить-выпуск

Получает подробную информацию о конкретной проблеме.

Параметры:

• project_id : идентификатор проекта, содержащего проблему

• issue_id : идентификатор проблемы, которую необходимо получить

Пример:

обновление-выпуск

Обновляет существующую проблему в проекте.

Параметры:

• project_id : идентификатор проекта, содержащего проблему

• issue_id : идентификатор проблемы для обновления

• name (необязательно): обновленное название выпуска

• description_html (необязательно): HTML-описание проблемы (требуется для API Plane)

• priority (необязательно): обновленный приоритет проблемы

• state_id (необязательно): обновленный идентификатор состояния проблемы

• assignees (необязательно): обновленный массив идентификаторов пользователей для назначения этой проблеме

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

Пример:

Разработка

1. Установка зависимостей разработки:

2. Запустите сервер в режиме разработки:

Тестирование

Вы можете протестировать сервер с помощью MCP Inspector:

Примеры

Вот несколько примеров взаимодействия, которые вы можете попробовать с Клодом после настройки сервера Plane MCP:

1. «Можете ли вы составить список всех проектов в моем рабочем пространстве Plane?»

2. «Пожалуйста, создайте новую высокоприоритетную задачу в маркетинговом проекте под названием «Обновление стратегии социальных сетей»»

3. «Каковы наиболее приоритетные вопросы в проекте развития?»

4. «Обновить задачу № 123 в проекте QA, изменив ее приоритет на срочный»

Клод будет использовать соответствующие инструменты для взаимодействия с Plane, запрашивая ваше одобрение перед созданием или изменением любых задач.

Соображения безопасности

• Для работы API-ключа требуются соответствующие разрешения Plane.

• Все операции, изменяющие данные, требуют явного одобрения пользователя.

• Переменные среды должны быть надежно защищены.

• Ключи API никогда не следует передавать в систему контроля версий.

Внося вклад

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Поддерживать

Если у вас возникли проблемы или есть вопросы:

1. Проверьте раздел GitHub Issues

2. Ознакомьтесь с документацией MCP на сайте modelcontextprotocol.io.

3. Откройте новый выпуск с подробными шагами воспроизведения

История Звезды