Supports running the MCP server on Linux platforms, enabling OS-level interactions like notifications and command-line prompts
Supports macOS-specific optimizations with Terminal.app profile settings for improved window management when the MCP server starts and stops
Provides a Model Context Protocol server that runs locally alongside MCP clients, with direct access to the user's operating system for notifications and interactive prompts
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이 로컬 머신에서 사용자와 직접 상호 작용해야 하는 다음과 같은 시나리오에 이상적입니다.
이 섹션에서는 interactive-mcp 서버를 사용하도록 MCP 클라이언트를 구성하는 방법을 설명합니다.
기본적으로 사용자 프롬프트는 30초 후에 시간 초과됩니다. 클라이언트를 구성할 때 args 배열에 명령줄 플래그를 직접 추가하여 시간 초과 또는 도구 비활성화와 같은 서버 옵션을 사용자 지정할 수 있습니다.
npx 명령을 사용할 수 있는지 확인하세요.
다음의 최소 구성을 claude_desktop_config.json (Claude Desktop) 또는 mcp.json (Cursor)에 추가합니다.
지엑스피1
사용자 정의 시간 제한(30초)을 사용한 예:
다음의 최소 구성을 사용자 설정(JSON) 파일이나 .vscode/mcp.json 에 추가합니다.
기본 Terminal.app 사용하여 macOS에서 더 원활한 환경을 얻으려면 다음 프로필 설정을 고려하세요.
이 섹션은 주로 서버를 수정하거나 서버에 기여하려는 개발자를 위한 것입니다. MCP 클라이언트와 함께 서버를 사용 하려면 위의 "클라이언트 구성" 섹션을 참조하세요.
package.json 확인하세요.npm install -g pnpm 사용하여 설치하세요.interactive-mcp 서버는 다음 명령줄 옵션을 허용합니다. 이러한 옵션은 일반적으로 MCP 클라이언트의 JSON 설정에서 args 배열에 직접 추가하여 구성해야 합니다("클라이언트 구성" 예시 참조).
| 옵션 | 별명 | 설명 |
|---|---|---|
--timeout | -t | 사용자 입력 프롬프트의 기본 시간 초과(초)를 설정합니다. 기본값은 30초입니다. |
--disable-tools | -d | 특정 도구나 그룹을 비활성화합니다(쉼표로 구분된 목록). 서버가 해당 도구나 그룹을 광고하거나 등록하지 않도록 합니다. 옵션: request_user_input , message_complete_notification , intensive_chat . |
예: 클라이언트 구성 args 배열에 여러 옵션 설정:
pnpm buildpnpm lintpnpm format이 MCP 서버와 상호 작용할 때(예: LLM 클라이언트로서), 명확성을 보장하고 예상치 못한 변경을 줄이려면 다음 원칙을 준수하세요.
request_user_input , start_intensive_chat 등)를 자주 활용하여 사용자와 소통하세요.다음과 같이 LLM 클라이언트에게 해당 지침을 제공할 수 있습니다.
기여를 환영합니다! 표준 개발 관행을 준수해 주세요. (자세한 내용은 추후 추가될 수 있습니다.)
MIT(자세한 내용은 LICENSE 파일을 참조하세요. 해당되는 경우 또는 라이선스를 직접 지정하세요).
You must be authenticated.
LLM과 사용자 간의 대화형 커뮤니케이션을 원활하게 하는 Node.js/TypeScript MCP 서버로, AI 어시스턴트가 사용자 입력을 요청하고, 알림을 표시하고, 명령줄 채팅 세션을 관리할 수 있도록 합니다.