Modes MCP Server

by ccc0168
Verified

local-only server

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

Integrations

  • Used for environment variable configuration through .env files

  • Used for version control and cloning the repository

  • Used as the source repository for the MCP server code

모드 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 라이선스 - 자세한 내용은 라이선스를 참조하세요.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

모드 MCP 서버를 사용하면 사용자 정의 운영 모드에 대한 포괄적인 관리 및 제어가 가능하며, 전체 CRUD 작업, 스키마 검증, 실시간 구성 변경을 지원하여 향상된 모드 관리를 구현할 수 있습니다.

  1. Features
    1. Installation
      1. Configuration
        1. 1. Environment Variables
        2. 2. Custom Modes Configuration
        3. 3. MCP Settings
      2. Operational Modes Framework
        1. Core System Modes
        2. Specialized Modes
      3. Mode Transition Flow
        1. Available Tools
          1. list_modes
          2. get_mode
          3. create_mode
          4. update_mode
          5. delete_mode
          6. validate_mode
        2. Mode Configuration Schema
          1. Development
            1. Best Practices
              1. Error Handling
                1. Testing
                  1. Contributing
                    1. License
                      ID: kxbyxtgfut