Project MCP Server

프로젝트 MCP 서버

프로젝트 지식 그래프를 관리하고 프로젝트, 작업, 마일스톤, 리소스 및 팀원을 체계적으로 표현할 수 있는 도구를 제공하는 MCP 서버 구현입니다. 이 서버는 프로젝트 관리자가 진행 상황을 추적하고, 위험을 관리하고, 리소스를 할당하고, 정보에 기반한 의사 결정을 내리는 데 도움을 줍니다.

특징

• 지속적인 프로젝트 컨텍스트 : 여러 세션에 걸쳐 프로젝트 엔터티 및 관계에 대한 구조화된 지식 그래프를 유지합니다.
• 세션 관리 : 고유 ID로 프로젝트 관리 세션을 추적하고 시간 경과에 따른 진행 상황을 기록합니다.
• 프로젝트 상태 추적 : 프로젝트 상태, 위험 및 문제 상태를 실시간으로 모니터링합니다.
• 작업 종속성 : 작업 간 종속성을 시각화하고 관리하여 병목 현상을 식별합니다.
• 이정표 진행 상황 : 주요 프로젝트 이정표에 대한 진행 상황을 추적합니다.
• 리소스 할당 : 프로젝트 및 작업에 리소스가 어떻게 분배되는지 모니터링합니다.
• 위험 평가 : 프로젝트 위험 식별, 모니터링 및 완화
• 의사결정 로깅 : 중요한 프로젝트 의사결정과 그 맥락을 기록합니다.
• 팀원 관리 : 팀원의 업무 및 작업량을 추적합니다.
• 프로젝트 타임라인 분석 : 중요 경로를 포함한 프로젝트 타임라인 분석

엔티티

Project MCP 서버는 다음 엔터티 유형을 인식합니다.

• 프로젝트 : 모든 관련 엔터티를 위한 주요 컨테이너
• task : 완료해야 하는 개별 작업 항목
• 이정표 : 프로젝트의 주요 체크포인트 또는 성과물
• 리소스 : 프로젝트에 필요한 재료, 도구 또는 자산
• 팀 멤버 : 프로젝트에 참여하는 사람들
• 참고 : 문서, 아이디어 또는 관찰
• 문서 : 공식 프로젝트 문서
• 이슈 : 문제 또는 방해 요소
• 위험 : 잠재적인 미래 문제
• 결정 : 프로젝트 중에 내린 중요한 선택
• 종속성 : 외부 요구 사항 또는 전제 조건
• 구성 요소 : 프로젝트의 일부 또는 모듈
• 이해 관계자 : 프로젝트의 영향을 받거나 프로젝트에 관심이 있는 사람들
• 변경 : 프로젝트 범위 또는 요구 사항에 대한 수정
• 상태 : 엔터티 상태 값(비활성, 활성, 완료)
• 우선순위 : 우선순위 수준 값(높음, 낮음)

관계

엔터티는 다음 관계 유형을 통해 연결될 수 있습니다.

• part_of : 엔터티가 다른 엔터티의 구성 요소/하위 집합임을 나타냅니다.
• depends_on : 엔티티 간의 종속성을 보여줍니다.
• assigned_to : 작업을 팀원에게 연결합니다.
• created_by : 엔티티를 만든 사람을 추적합니다.
• modified_by : 엔터티를 변경한 레코드
• related_to : 엔터티 간의 일반적인 연결을 표시합니다.
• 블록 : 한 엔터티가 다른 엔터티를 차단하고 있음을 나타냅니다.
• 관리 : 관리 관계를 보여줍니다
• contributes_to : 엔터티에 대한 기여를 보여줍니다.
• 문서 : 문서를 엔터티에 연결합니다.
• scheduled_for : 엔터티를 날짜 또는 시간대에 연결합니다.
• responsible_for : 소유권/책임을 할당합니다.
• reports_to : 보고 관계를 나타냅니다.
• categoryized_as : 엔터티를 카테고리 또는 유형에 연결합니다.
• 필수_대상 : 완료에 필요한 요구 사항을 표시합니다.
• discovered_in : 이슈를 해당 발견 컨텍스트에 연결합니다.
• resolved_by : 문제가 어떻게 해결되었는지 보여줍니다.
• impacted_by : 영향 관계를 보여줍니다
• stakeholder_of : 이해관계자를 프로젝트/구성요소에 연결합니다.
• prioritized_as : 우선순위 수준을 나타냅니다.
• has_status : 엔티티를 현재 상태(비활성, 활성, 완료)에 연결합니다.
• has_priority : 엔티티를 우선순위 수준(높음, 낮음)에 연결합니다.
• 선행 : 순서상 한 작업이 다른 작업보다 먼저 나온다는 것을 나타냅니다.

사용 가능한 도구

Project MCP 서버는 프로젝트 지식과 상호 작용하기 위한 다음과 같은 도구를 제공합니다.

시작 세션

새 프로젝트 관리 세션을 시작하고, 고유 세션 ID를 생성하며, 현재 프로젝트, 작업, 마일스톤, 위험 및 최근 세션을 표시합니다. has_status 관계를 통해 상태 정보를, has_priority 관계를 통해 우선순위를 표시하며, 순차적 종속성을 기반으로 다음 작업으로 진행할 준비가 된 작업을 식별합니다.

로드 컨텍스트

특정 엔터티(프로젝트, 작업 등)에 대한 자세한 컨텍스트를 로드하고 엔터티 유형에 따라 관련 정보를 표시합니다. 상태 정보(비활성, 활성, 완료), 우선순위 수준(높음, 낮음) 및 순차적 작업 관계가 포함됩니다.

세션 종료

구조화된 다단계 프로세스를 통해 프로젝트 관리 세션의 결과를 기록합니다.

1. 요약 : 세션 요약, 기간 및 프로젝트 초점을 기록합니다.
2. 성과 : 세션의 주요 성과를 문서화합니다.
3. taskUpdates : 기존 작업에 대한 업데이트를 추적합니다.
4. newTasks : 세션 중에 생성된 새 작업을 기록합니다.
5. statusUpdates : 엔터티 상태 값의 변경 사항을 기록합니다.
6. projectStatus : 전체 프로젝트 상태, 우선순위 할당 및 순차적 관계를 업데이트합니다.
7. 어셈블리 : 모든 세션 데이터의 최종 어셈블리

빌드 컨텍스트

지식 그래프에 새로운 엔터티, 관계 또는 관찰을 생성합니다.

• 엔터티 : 새로운 프로젝트 관련 엔터티(프로젝트, 작업, 이정표, 상태, 우선순위 등)를 추가합니다.
• 관계 : 엔티티 간 관계 생성(has_status, has_priority, precedes 포함)
• 관찰 : 기존 엔터티에 관찰 추가

컨텍스트 삭제

지식 그래프에서 엔터티, 관계 또는 관찰을 제거합니다.

• 엔티티 : 프로젝트 엔티티 제거
• 관계 : 엔터티 간 관계(상태, 우선순위, 순차 관계 포함)를 제거합니다.
• 관찰 : 엔터티에서 특정 관찰을 제거합니다.

고급 컨텍스트

지식 그래프에서 정보를 검색합니다.

• 그래프 : 전체 지식 그래프를 가져옵니다
• 검색 : 쿼리 기준에 따라 노드 검색
• 노드 : 이름으로 특정 노드 가져오기
• 관련 : 관련 엔터티 찾기
• 상태 : 특정 상태 값(비활성, 활성, 완료)을 가진 엔터티 찾기
• 우선순위 : 특정 우선순위 값(높음, 낮음)을 가진 엔터티 찾기
• 순서 : 작업에 대한 순차적 관계 식별

도메인별 기능

Project MCP 서버에는 프로젝트 관리를 위한 특수 도메인 기능이 포함되어 있습니다.

• getProjectOverview : 작업, 이정표, 팀 구성원, 이슈 등을 포함한 프로젝트에 대한 포괄적인 보기입니다.
• getTaskDependencies : 작업 종속성을 분석하여 차단된 작업과 중요 경로를 식별합니다.
• getTeamMemberAssignments : 특정 팀원의 모든 과제를 봅니다.
• getMilestoneProgress : 프로젝트 마일스톤에 대한 진행 상황을 추적합니다.
• getProjectTimeline : 프로젝트 타임라인 및 주요 날짜 분석
• getResourceAllocation : 프로젝트 전체에서 리소스가 어떻게 할당되는지 조사합니다.
• getProjectRisks : 프로젝트 위험 식별 및 평가
• findRelatedProjects : 서로 다른 프로젝트 간의 연결을 검색합니다.
• getDecisionLog : 의사결정 기록 및 컨텍스트 추적
• getProjectHealth : 지표와 권장 사항을 통해 전반적인 프로젝트 상태를 평가합니다.
• getStatusOverview : 특정 상태(비활성, 활성, 완료)의 모든 엔터티를 봅니다.
• getPriorityItems : 우선순위가 높은 작업 및 활동 식별
• getTaskSequence : Precedes 관계에 따라 작업 순서를 시각화합니다.

예시 프롬프트

세션 시작

지엑스피1

프로젝트 컨텍스트 로딩 중

녹음 세션 결과

프로젝트 지식 관리

용법

이 MCP 서버를 통해 프로젝트 관리자는 다음을 수행할 수 있습니다.

• 컨텍스트 연속성 유지 : 여러 계획 세션에서 프로젝트 세부 정보를 추적합니다.
• 신규 팀원 온보딩 : 프로젝트 현황에 대해 신규 팀원을 신속하게 최신 상태로 유지
• 세션 결과 기록 : 회의 및 작업 세션의 결과를 문서화합니다.
• 종속성 추적 : 중요한 종속성 및 병목 현상을 식별하고 관리합니다.
• 위험 모니터링 : 프로젝트 위험을 추적하고 완화 전략을 구현합니다.
• 리소스 할당 : 프로젝트 및 작업 전반에 걸쳐 리소스 할당을 최적화합니다.
• 정보에 입각한 의사 결정: 포괄적인 프로젝트 데이터를 기반으로 의사 결정을 내립니다.
• 진행 상황 추적 : 프로젝트 수명 주기 전반에 걸쳐 엔터티 상태를 모니터링합니다.
• 작업 우선순위 지정 : 우선순위가 높은 작업을 식별하고 집중합니다.
• 시퀀스 작업 : 프로젝트 작업의 논리적 순서를 계획하고 시각화합니다.

구성

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

GitHub에서 설치하고 npx로 실행하세요

전역적으로 설치하고 직접 실행하세요

먼저, 패키지를 전역으로 설치합니다.

그런 다음 Claude Desktop을 구성합니다.

도커

건물

출처에서

도커:

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

환경 변수

Project MCP 서버는 데이터가 저장되는 위치를 사용자 지정하기 위해 다음 환경 변수를 지원합니다.

• MEMORY_FILE_PATH : 지식 그래프 데이터가 저장될 경로
  • 절대 경로 또는 상대 경로가 될 수 있습니다(상대 경로는 현재 작업 디렉토리를 사용함)
  • 기본값: ./project/memory.json
• SESSIONS_FILE_PATH : 세션 데이터가 저장될 경로
  • 절대 경로 또는 상대 경로가 될 수 있습니다(상대 경로는 현재 작업 디렉토리를 사용함)
  • 기본값: ./project/sessions.json

사용 예: