makeplane/plane-mcp-server

Plane MCP Server – 개요

Plane MCP Server는 AI 에이전트가 Model Context Protocol (MCP) 을 통해 Plane 프로젝트 관리 플랫폼과 통신할 수 있게 해주는 작은 Python 서비스입니다. LLM 기반 어시스턴트가 이해하는 일반적인 MCP 호출을 공식 plane-sdk를 사용하여 Plane의 REST API에 대한 구체적인 호출로 변환합니다.

AI 에이전트에게 중요한 이유

도구 기반 에이전트 – 최신 LLM 에이전트(Claude, ChatGPT 등)는 모델 외부에서 작업을 수행하기 위해 도구를 사용합니다. 이 서버는 30개 이상의 “도구”를 노출하며, 각 도구는 Plane 리소스(프로젝트, 작업 항목, 사이클, 릴리스, 고객 등)와 일련의 작업(생성, 목록, 보관 등)을 나타냅니다.
자체 문서화 – 각 도구는 런타임에 작업과 필수 매개변수를 알리므로 에이전트는 스키마를 하드코딩하지 않고 수행할 수 있는 작업을 발견할 수 있습니다.
다중 전송 – 서버는 로컬 하위 프로세스(stdio) 또는 HTTP 엔드포인트(OAuth 또는 API 키 인증)로 실행할 수 있습니다. 이는 현재 MCP 지원 클라이언트가 구축되는 방식과 일치합니다.

핵심 기능(README에 설명됨)

기능	세부 사항
30개 도구	Plane 리소스당 하나씩, 총 207개의 개별 작업을 포함합니다.
전송 옵션	• `stdio` – MCP 클라이언트의 하위 프로세스로 실행. • HTTP + OAuth – 호스팅 엔드포인트 `https://mcp.plane.so/http/mcp`. • HTTP + 개인 액세스 토큰 – `https://mcp.plane.so/http/api-key/mcp`. • SSE – 더 이상 사용되지 않지만 이전 버전과의 호환성을 위해 유지.
인증	• API 키(`PLANE_API_KEY`)를 stdio에 사용. • OAuth 흐름은 호스팅 HTTP 전송에서 자동 처리. • 베어러 토큰(`Authorization: Bearer <PAT>`)을 API 키 HTTP 전송에 사용.
쿼리 언어	작업 항목을 나열하거나 계산할 때 강력한 필터링을 위해 Plane의 PQL을 지원합니다.
호환성 계층	이전의 작업별 도구 이름(177개 중 169개)이 여전히 해결되므로 기존 프롬프트나 스크립트가 계속 작동합니다.
구성 가능한 프록시	첨부 파일 업로드 URL에 대해 `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY`를 존중합니다.
로깅	구조화된 JSON 로그. 사용자 정보 및 페이로드의 선택적 포함.
개발 친화성	오프라인 테스트 스위트, `ruff`를 사용한 린팅, 명확한 기여 지침.

일반적인 사용 흐름

Plane API 토큰 획득(또는 OAuth에 의존).
MCP 클라이언트 구성 – plane-mcp-server를 시작하는 명령(예: uvx plane-mcp-server stdio)을 설정.
클라이언트는 workitem(action="list", project_id=…, pql='state__group = "started"')와 같은 MCP 요청을 보냅니다.
서버는 이를 plane-sdk에 대한 호출로 변환하고 결과를 반환하며 호출을 기록합니다.

누가 사용할까?

LLM 기반 어시스턴트 – Plane 작업 공간을 읽거나 수정해야 하는 경우(예: “프로젝트 매니저 봇”).
IDE 확장(VS Code, Cursor, Claude.ai 커넥터) – 채팅 기반 워크플로에 Plane 작업을 노출.
사용자 지정 자동화 – 개발자가 원시 Plane SDK 코드를 작성하는 대신 안정적인 MCP 엔드포인트를 원하는 경우.

라이선스 및 커뮤니티

이 프로젝트는 MIT 라이선스이며, 풀 리퀘스트를 환영하고 오프라인에서 실행할 수 있는 전체 테스트 스위트를 제공합니다. 이전의 Node.js 구현을 대체하고 기능을 Python 패키지로 통합합니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.