인터랙티브-mcp

Node.js/TypeScript로 구현된 MCP 서버로, LLM과 사용자 간의 상호작용을 원활하게 합니다. 참고: 이 서버는 알림 및 명령줄 프롬프트를 표시하기 위해 사용자 운영 체제에 직접 액세스해야 하므로 MCP 클라이언트(예: Claude Desktop, VS Code)와 함께 로컬에서 실행되도록 설계되었습니다.

(참고: 이 프로젝트는 초기 단계에 있습니다.)

간략하게 살펴보고 싶으신가요? 소개 블로그 게시물을 확인해 보세요: AI 비서의 추측 방지 — interactive-mcp 소개

데모 비디오

도구

이 서버는 MCP(Model Context Protocol)를 통해 다음 도구를 제공합니다.

request_user_input : 사용자에게 질문을 하고 답변을 반환합니다. 미리 정의된 옵션을 표시할 수 있습니다.
message_complete_notification : 간단한 OS 알림을 보냅니다.
start_intensive_chat : 지속적인 명령줄 채팅 세션을 시작합니다.
ask_intensive_chat : 활성화된 집중 채팅 세션 내에서 질문을 합니다.
stop_intensive_chat : 활성화된 집중 채팅 세션을 닫습니다.

데모

다음은 대화형 기능의 데모입니다.

일반 질문	완료 알림

집중 채팅 시작	집중 채팅 종료

사용 시나리오

이 서버는 LLM이 로컬 머신에서 사용자와 직접 상호 작용해야 하는 다음과 같은 시나리오에 이상적입니다.

대화형 설정 또는 구성 프로세스.
코드 생성이나 수정 중에 피드백을 수집합니다.
페어 프로그래밍에서 지시사항을 명확히 하거나 동작을 확인합니다.
LLM 작업 중 사용자 입력이나 확인이 필요한 모든 워크플로입니다.

클라이언트 구성

이 섹션에서는 interactive-mcp 서버를 사용하도록 MCP 클라이언트를 구성하는 방법을 설명합니다.

기본적으로 사용자 프롬프트는 30초 후에 시간 초과됩니다. 클라이언트를 구성할 때 args 배열의 "--" 뒤에 명령줄 플래그를 추가하여 시간 초과 또는 도구 비활성화와 같은 서버 옵션을 사용자 지정할 수 있습니다.

npx 명령을 사용할 수 있는지 확인하세요.

Claude Desktop/Cursor 사용

다음의 최소 구성을 claude_desktop_config.json (Claude Desktop) 또는 mcp.json (Cursor)에 추가합니다.

지엑스피1

사용자 정의 시간 초과(60초)의 예:

{
  "mcpServers": {
    "interactive": {
      "command": "npx",
      "args": ["-y", "interactive-mcp", "--", "-t", "60"]
    }
  }
}

VS Code를 사용한 사용

다음의 최소 구성을 사용자 설정(JSON) 파일이나 .vscode/mcp.json 에 추가합니다.

{
  "mcp": {
    "servers": {
      "interactive-mcp": {
        "command": "npx",
        "args": ["-y", "interactive-mcp"]
      }
    }
  }
}

macOS 권장 사항

기본 Terminal.app 사용하여 macOS에서 더 원활한 환경을 얻으려면 다음 프로필 설정을 고려하세요.

(셸 탭): "셸 종료 시" ( 터미널 > 설정 > 프로필 > [내 프로필] > 셸 )에서 "셸이 정상적으로 종료되면 닫기" 또는 "창 닫기"를 선택하세요. 이 설정은 MCP 서버 시작 및 종료 시 창을 관리하는 데 도움이 됩니다.
(고급 탭): 입력 ( 터미널 > 설정 > 프로필 > [내 프로필] > 고급 )에서 "삭제 시 Control-H 전송" 옵션의 선택을 해제하세요. 기본적으로 macOS 터미널은 Delete 키를 누를 때 Control-H(ASCII 백스페이스) 키를 전송합니다. 이 옵션을 해제하면 다른 시퀀스를 요구하는 애플리케이션에서는 도움이 될 수 있지만, \033[3~ (종종 정방향 삭제에 필요함)와 같은 특정 시퀀스를 구현하려면 다른 설정이나 터미널 대안이 필요할 수 있습니다.

개발 설정

이 섹션은 주로 서버를 수정하거나 서버에 기여하려는 개발자를 위한 것입니다. MCP 클라이언트와 함께 서버를 사용 하려면 위의 "클라이언트 구성" 섹션을 참조하세요.

필수 조건

Node.js: 버전 호환성을 위해 package.json 확인하세요.
pnpm: 패키지 관리에 사용됩니다. Node.js를 설치한 후 npm install -g pnpm 사용하여 설치하세요.

설치(개발자)

저장소를 복제합니다.
git clone https://github.com/ttommyth/interactive-mcp.git cd interactive-mcp
종속성 설치:
pnpm install

애플리케이션 실행(개발자)

pnpm start

명령줄 옵션

interactive-mcp 서버는 다음 명령줄 옵션을 허용합니다. 이러한 옵션은 일반적으로 MCP 클라이언트의 JSON 설정에서 args 배열의 "--" 구분 기호 뒤에 추가하여 구성해야 합니다("클라이언트 구성" 예시 참조).

옵션	별명	설명
`--timeout`	`-t`	사용자 입력 프롬프트의 기본 시간 초과(초)를 설정합니다. 기본값은 30초입니다.
`--disable-tools`	`-d`	특정 도구나 그룹을 비활성화합니다(쉼표로 구분된 목록). 서버가 해당 도구나 그룹을 광고하거나 등록하지 않도록 합니다. 옵션: `request_user_input` , `message_complete_notification` , `intensive_chat` .

예: 클라이언트 구성 args 배열에 여러 옵션 설정:

// Example combining options in client config's "args":
// ... (other args like "-y", "interactive-mcp")
"--", // Separator for server arguments
"-t", "90", // Set timeout to 90 seconds
"--disable-tools", "message_complete_notification,intensive_chat" // Disable notifications and intensive chat
// ...

개발 명령

빌드: pnpm build
린트: pnpm lint
형식: pnpm format

상호작용을 위한 지침 원칙

이 MCP 서버와 상호 작용할 때(예: LLM 클라이언트로서), 명확성을 보장하고 예상치 못한 변경을 줄이려면 다음 원칙을 준수하세요.

상호작용을 우선시하세요. 제공된 MCP 도구( request_user_input , start_intensive_chat 등)를 자주 활용하여 사용자와 소통하세요.
명확한 설명을 구하세요: 요구 사항, 지침 또는 맥락이 불분명한 경우, 진행하기 전에 항상 명확한 질문을 하세요. 섣불리 추측하지 마세요.
작업 확인: 중요한 작업(파일 수정, 복잡한 명령 실행, 아키텍처 결정 등)을 수행하기 전에 사용자와 계획을 확인하세요.
옵션 제공: 가능한 경우 MCP 도구를 통해 미리 정의된 옵션을 사용자에게 제공하여 빠른 의사 결정을 돕습니다.

다음과 같이 LLM 클라이언트에게 해당 지침을 제공할 수 있습니다.

# Interaction

- Please use the interactive MCP tools
- Please provide options to interactive MCP if possible

# Reduce Unexpected Changes

- Do not make assumption.
- Ask more questions before executing, until you think the requirement is clear enough.

기여하다

기여를 환영합니다! 표준 개발 관행을 준수해 주세요. (자세한 내용은 추후 추가될 수 있습니다.)

특허

MIT(자세한 내용은 LICENSE 파일을 참조하세요. 해당되는 경우 또는 라이선스를 직접 지정하세요).

interactive-mcp

Integrations