Servidor MCP de avión

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar con Plane.so , lo que les permite gestionar proyectos e incidencias mediante la API de Plane. Con este servidor, LLM como Claude pueden interactuar directamente con sus flujos de trabajo de gestión de proyectos, manteniendo el control y la seguridad de los usuarios.

Características

• Enumere todos los proyectos en su espacio de trabajo de Plane

• Obtenga información detallada sobre proyectos específicos

• Crea nuevos problemas con propiedades personalizables

• Enumerar y filtrar problemas de los proyectos

• Obtenga información detallada sobre temas específicos

• Actualizar los problemas existentes con nueva información

Related MCP server: Plane MCP Server

Prerrequisitos

• Node.js 22.x o superior

• Una clave API de Plane.so

• Un espacio de trabajo de Plane.so

Instalación

Opción 1: Uso de herrería

La forma más rápida de comenzar es usar Smithery para instalar el servidor directamente:

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

Este comando configurará automáticamente el servidor MCP de Plane para su uso con Claude. Tras la instalación, deberá configurar el servidor con su clave API de Plane y el slug del espacio de trabajo a través de la configuración de Claude.

Las opciones de cliente válidas son: claude, cline, windsurf, roo-cline, witsy, enconvo, cursor

Ejemplo de instalación con Cursor:

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

Opción 2: Configuración manual

Si prefiere configurar el servidor manualmente, siga estos pasos:

1. Clonar este repositorio:

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

2. Instalar dependencias:

npm install

3. Construir el servidor:

npm run build

Uso con Claude para escritorio

Nota: Si usó la Opción 1 (Smithery) mencionada anteriormente, puede omitir esta sección. Smithery configura automáticamente el servidor MCP.

1. Abra el archivo de configuración de Claude for Desktop:

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

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

2. Agregue la configuración del servidor 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. Reiniciar Claude para escritorio

Herramientas disponibles

Nota: Los nombres de las herramientas usan guiones (p. ej., list-projects ), no guiones bajos. El servidor convertirá automáticamente los guiones bajos a guiones para mayor compatibilidad.

lista-proyectos

Enumera todos los proyectos en su espacio de trabajo de Plane.

Parámetros: Ninguno

Ejemplo:

{}

obtener-proyecto

Obtiene información detallada sobre un proyecto específico.

Parámetros:

• project_id : ID del proyecto a recuperar

Ejemplo:

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

crear problema

Crea un nuevo problema en un proyecto específico.

Parámetros:

• project_id : ID del proyecto donde se debe crear el problema

• name : Título del número

• description_html : Descripción HTML del problema (requerida por la API de Plane)

• priority (opcional): Prioridad del asunto ("urgente", "alta", "media", "baja", "ninguna")

• state_id (opcional): ID del estado para este problema

• assignees (opcional): Matriz de ID de usuarios para asignar a este problema

Nota: El parámetro assignees debe ser una matriz de cadenas de ID de usuario. Errores comunes incluyen proporcionar un diccionario/objeto en lugar de una matriz, o anidar accidentalmente todos los datos del problema dentro del campo "assignees". El servidor intentará gestionar estos casos, pero se recomienda usar el formato correcto.

Ejemplo:

{
  "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"]
}

problemas de lista

Enumera los problemas de un proyecto específico con filtrado opcional.

Parámetros:

• project_id : ID del proyecto del cual se obtendrán los problemas

• state_id (opcional): Filtrar por ID de estado

• priority (opcional): Filtrar por prioridad

• assignee_id (opcional): Filtrar por ID de cesionario

• limit (opcional): número máximo de números a devolver (predeterminado: 50)

Ejemplo:

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

obtener problema

Obtiene información detallada sobre un problema específico.

Parámetros:

• project_id : ID del proyecto que contiene el problema

• issue_id : ID del problema a recuperar

Ejemplo:

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

problema de actualización

Actualiza un problema existente en un proyecto.

Parámetros:

• project_id : ID del proyecto que contiene el problema

• issue_id : ID del problema a actualizar

• name (opcional): Título actualizado del problema

• description_html (opcional): descripción HTML del problema (requerida por la API de Plane)

• priority (opcional): Prioridad actualizada del problema

• state_id (opcional): ID de estado actualizado del problema

• assignees (opcional): matriz actualizada de identificaciones de usuarios para asignar a este problema

Nota: El parámetro assignees debe ser una matriz de cadenas de identificación de usuario, siguiendo las mismas pautas de formato que la herramienta de creación de problemas.

Ejemplo:

{
  "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>"
}

Desarrollo

1. Instalar dependencias de desarrollo:

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

2. Inicie el servidor en modo de desarrollo:

npm run dev

Pruebas

Puede probar el servidor utilizando el Inspector MCP:

npx @modelcontextprotocol/inspector node dist/index.js

Ejemplos

A continuación se muestran algunos ejemplos de interacciones que puedes probar con Claude después de configurar el servidor Plane MCP:

1. "¿Puedes enumerar todos los proyectos en mi espacio de trabajo de Plane?"

2. Por favor, cree un nuevo problema de alta prioridad en el proyecto de Marketing titulado "Actualizar la estrategia de redes sociales".

3. "¿Cuáles son todos los temas de alta prioridad en el proyecto de desarrollo?"

4. Se actualizó el problema n.° 123 del proyecto de control de calidad para cambiar su prioridad a urgente.

Claude utilizará las herramientas adecuadas para interactuar con Plane y solicitará su aprobación antes de crear o modificar cualquier problema.

Consideraciones de seguridad

• La clave API requiere permisos de avión adecuados para funcionar

• Todas las operaciones que modifican datos requieren la aprobación explícita del usuario

• Las variables de entorno deben estar protegidas adecuadamente

• Las claves API nunca deben comprometerse con el control de versiones

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

Si encuentra algún problema o tiene preguntas:

1. Consulta la sección de problemas de GitHub

2. Consulte la documentación de MCP en modelcontextprotocol.io

3. Abrir una nueva emisión con pasos de reproducción detallados

Historia de las estrellas