Modes MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports environment variable configuration through .env files

  • Supported in the custom modes configuration with specific file permissions through fileRegex patterns

  • Used for visualizing mode transition flows in the documentation

모드 MCP 서버

Roo의 사용자 정의 운영 모드를 관리하고 모드 구성 및 관리에 대한 프로그래밍 방식 제어를 제공하는 MCP 서버입니다.

특징

  • 사용자 정의 모드에 대한 전체 CRUD 작업
  • Zod를 사용한 스키마 검증
  • 구성 변경 사항을 감시하는 파일 시스템
  • 표준 MCP 오류 코드를 사용한 오류 처리
  • 원자 파일 작업

설치

지엑스피1

구성

1. 환경 변수

.env.example .env 로 복사하고 필요에 따라 조정합니다.

cp .env.example .env

사용 가능한 환경 변수:

  • MODES_CONFIG_PATH : 사용자 정의 모드 구성 파일 경로(기본값: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json )

2. 사용자 정의 모드 구성

사용자 지정 모드 구성을 위한 JSON 파일을 만드세요. 파일 형식은 examples/modes.example.json 참조하세요.

{ "customModes": [ { "slug": "example-mode", "name": "Example Mode", "roleDefinition": "Example role definition describing the mode's capabilities and responsibilities.", "groups": [ "read", ["edit", { "fileRegex": "\\.md$", "description": "Can edit markdown files only" }], "command", "mcp" ], "customInstructions": "Example custom instructions for the mode." } ] }

3. MCP 설정

MCP 설정 파일(일반적으로 %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json )에 서버 구성을 추가합니다. 형식은 examples/mcp-settings.example.json 참조하세요.

{ "mcpServers": { "modes": { "command": "node", "args": ["/path/to/modes-mcp-server/build/index.js"], "env": { "MODES_CONFIG_PATH": "/path/to/custom/modes.json" }, "disabled": false, "alwaysAllow": [] } } }

운영 모드 프레임워크

서버는 포괄적인 일련의 운영 모드를 관리합니다.

핵심 시스템 모드

  1. 계획 모드 🎯
    • 전략 기획 전문가
    • 시스템 설계 및 자원 할당
    • 프로젝트 로드맵 개발
  2. 분석 모드 📊
    • 데이터 분석 전문가
    • 메트릭 추적 및 분석
    • 성능 모니터링
  3. 연구 모드 🔍
    • 시스템 연구 전문가
    • 모범 사례 연구
    • 솔루션 탐색
  4. 구현 모드 ⚙️
    • 운영 구현 전문가
    • 시스템 배포
    • 프로세스 실행
  5. 문제 해결 모드 🔧
    • 시스템 해결 전문가
    • 문제 식별
    • 문제 해결
  6. 품질 관리 모드
    • 품질 보증 전문가
    • 시스템 검증
    • 성능 검증
  7. 통합 모드 🔄
    • 시스템 통합 전문가
    • 시스템 간 조정
    • 워크플로우 최적화
  8. 문서화 모드 📝
    • 지식 관리 전문가
    • 프로세스 문서화
    • 표준 유지 관리
  9. 세션 관리 모드
    • 세션 관리 전문가
    • 일일 워크플로 오케스트레이션
    • 국가 관리

특수 모드

  • 무역 운영 관리자
    • 체계적인 거래 및 위험 관리
    • 무역 문서화 및 분석
    • 시장 분석 및 전략 최적화

모드 전환 흐름

사용 가능한 도구

목록_모드

현재 구성된 모든 사용자 정의 모드를 나열합니다.

get_mode

슬러그를 통해 특정 모드의 세부 정보를 가져옵니다.

매개변수:

  • slug : 모드의 고유 식별자

생성_모드

새로운 사용자 정의 모드를 만듭니다.

매개변수:

  • slug : 고유 식별자(소문자, 숫자, 하이픈)
  • name : 모드의 표시 이름
  • roleDefinition : 모드의 역할과 기능에 대한 자세한 설명
  • groups : 허용된 도구 그룹의 배열
  • customInstructions : (선택 사항) 모드에 대한 추가 지침

업데이트 모드

기존 사용자 정의 모드를 업데이트합니다.

매개변수:

  • slug : 업데이트할 모드의 고유 식별자
  • updates : 업데이트할 필드(name, roleDefinition, groups, customInstructions)를 포함하는 객체

삭제_모드

사용자 정의 모드를 삭제합니다.

매개변수:

  • slug : 삭제할 모드의 고유 식별자

검증 모드

저장하지 않고 모드 구성을 검증합니다.

매개변수:

  • mode : 검증할 전체 모드 구성 객체

모드 구성 스키마

interface CustomMode { slug: string; // Lowercase letters, numbers, and hyphens only name: string; // Display name roleDefinition: string; // Detailed description groups: (string | [string, { fileRegex: string, description: string }])[]; customInstructions?: string; // Optional additional instructions }

개발

  1. src/ 의 소스 코드를 변경하세요
  2. 프로젝트를 빌드하세요:
npm run build
  1. 서버를 시작합니다:
npm start

모범 사례

  1. 모드 선택
    • 작업에 적합한 모드를 선택하세요
    • 모드별 워크플로를 따르세요
    • 지정된 도구 그룹 사용
  2. 모드 전환
    • 자연스러운 전환 흐름을 따르세요
    • 현재 모드 작업 완료
    • 모드 간 컨텍스트 유지
  3. 구성 관리
    • 저장하기 전에 변경 사항을 확인하세요
    • 명확한 역할 정의를 유지하세요
    • 문서 모드 기능

오류 처리

서버는 표준 MCP 오류 코드를 사용합니다.

  • InvalidParams : 잘못된 입력 매개변수 또는 모드를 찾을 수 없습니다.
  • MethodNotFound : 알 수 없는 도구가 요청되었습니다.
  • InternalError : 파일 시스템 오류 또는 기타 내부 문제

테스트

포괄적인 테스트 사례와 검증 절차는 TESTING.md를 참조하세요.

기여하다

  1. 포크 저장소
  2. 기능 브랜치 생성
  3. 풀 리퀘스트 제출
  4. 코딩 표준을 따르세요

특허

MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.

ID: kwqxkri24g