인터랙티브-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 : 활성화된 집중 채팅 세션을 닫습니다.

Related MCP server: MCP Server TypeScript Template

데모

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

사용 시나리오

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

• 대화형 설정 또는 구성 프로세스.

• 코드 생성이나 수정 중에 피드백을 수집합니다.

• 페어 프로그래밍에서 지시사항을 명확히 하거나 동작을 확인합니다.

• LLM 작업 중 사용자 입력이나 확인이 필요한 모든 워크플로입니다.

클라이언트 구성

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

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

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

Claude Desktop/Cursor 사용

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

지엑스피1

사용자 정의 시간 제한(30초)을 사용한 예:

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

VS Code를 사용한 사용

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

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

macOS 권장 사항

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

• (셸 탭): "셸 종료 시" ( 터미널 > 설정 > 프로필 > [내 프로필] > 셸 )에서 "셸이 정상적으로 종료되면 닫기" 또는 "창 닫기"를 선택하세요. 이 설정은 MCP 서버 시작 및 종료 시 창을 관리하는 데 도움이 됩니다.

개발 설정

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

필수 조건

• Node.js: 버전 호환성을 위해 package.json 확인하세요.

• pnpm: 패키지 관리에 사용됩니다. Node.js를 설치한 후 npm install -g pnpm 사용하여 설치하세요.

설치(개발자)

1. 저장소를 복제합니다.

   git clone https://github.com/ttommyth/interactive-mcp.git
   cd interactive-mcp

2. 종속성 설치:

   pnpm install

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

pnpm start

명령줄 옵션

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

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

// Example combining options in client config's "args":
"args": [
  "-y", "interactive-mcp",
  "-t", "30", // Set timeout to 30 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 파일을 참조하세요. 해당되는 경우 또는 라이선스를 직접 지정하세요).