Сервер MCP Plane

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

Функции

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

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

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

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

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

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

Related MCP server: Plane MCP Server

Предпосылки

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

• API-ключ Plane.so

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

Установка

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

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

# Install to Claude for Desktop
npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

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

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

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

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

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

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

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

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

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

npm install

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

npm run build

Использование с 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:

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

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

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

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

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

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

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

Пример:

{}

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

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

Параметры:

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

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

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

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

Параметры:

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

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

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

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

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

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

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

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "<p>We need to implement the new reporting feature</p>",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

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

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

Параметры:

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

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

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

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

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

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

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

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

Параметры:

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

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

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

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

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

Параметры:

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

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

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

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

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

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

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

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

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "<p>Updated description with <strong>more details</strong></p>"
}

Разработка

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

npm install --save-dev typescript @types/node

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

npm run dev

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

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

npx @modelcontextprotocol/inspector node dist/index.js

Примеры

Вот несколько примеров взаимодействия, которые вы можете попробовать с Клодом после настройки сервера 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. Откройте новый выпуск с подробными шагами воспроизведения

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