A
licenseNot graded
qualityB
maintenanceMCP server that enables AI agents to run a deterministic orchestration loop with decomposition, subagent execution, and review feedback across multiple LLM backends.
60
MIT
hcom-mcp
by scchearn
hcom-mcp
hcom이 관리하는 에이전트를 실행하고 감독하기 위한 제어 플레인 MCP 서버입니다.
왜 stdio가 아닌 HTTP인가
MCP 서버는 일반적으로 stdio를 통해 실행됩니다. 클라이언트는 세션마다 서버 프로세스 하나를 생성합니다. 에이전트 무리를 관리하는 제어 플레인 서버에게는 이것이 문제입니다. 터미널 세션 10개가 서로 조정되지 않는 격리된 MCP 프로세스 10개를 생성하기 때문입니다.
hcom-mcp는 단일 상주 HTTP 서버로 실행됩니다. 모든 터미널 세션, 모든 MCP 클라이언트, 모든 에이전트가 동일한 엔드포인트와 통신합니다. 하나의 프로세스, 즉 실행·레지스트리·수명주기에 대한 단일 진실 공급원입니다.
Related MCP server: GRACE Orchestrator MCP
사전 요구 사항
설치
git clone https://github.com/scchearn/hcom-mcp.git
cd hcom-mcp
npm install
npm run build실행
포그라운드 (모든 OS)
HCOM_MCP_PORT=3111 node dist/index.jshttp://127.0.0.1:3111/mcp에서 수신 대기합니다. localhost 연결만 허용됩니다.
데몬으로 실행
OS | 메커니즘 | 설정 |
Linux | systemd 사용자 서비스 |
|
macOS | launchd |
|
Windows | 작업 스케줄러 또는 nssm | 작업 스케줄러에 대해서는 |
리포지토리를 클론한 위치에 맞게 구성 파일의 ExecStart/ProgramArguments 경로를 조정하세요.
MCP 클라이언트 구성
HTTP를 지원하는 모든 MCP 클라이언트를 http://127.0.0.1:3111/mcp로 지정하세요. Claude Desktop 예시:
{
"mcpServers": {
"hcom-mcp": {
"type": "http",
"url": "http://127.0.0.1:3111/mcp"
}
}
}구성
HCOM_MCP_PORT— HTTP 포트(기본값:3111)~/.hcom/mcp/config.json— 프리셋, 토폴로지, 모델 카탈로그, 구조 허용 목록~/.hcom/mcp/registry.json— 관리형 에이전트 레지스트리.hcom-mcp.json— 선택적 워크스페이스 오버레이(.hcom-mcp.example.json참조)
구조 허용 목록
unblock과 spawn_and_verify는 대기 중인 launch_blocked 세부 정보가 rescueAllowlist의 패턴과 일치할 때만 차단된 에이전트에 입력을 주입합니다. 기본값은 알려진 구조 가능한 대화상자(워크스페이스 신뢰, 권한 모드, 모델/공급자 선택기)를 포함합니다. 코드 릴리스 없이 새 대화상자에 대한 패턴을 추가하세요:
{
"rescueAllowlist": {
"enabled": true,
"patterns": ["trust this folder", "permission mode"]
}
}워크스페이스 오버레이는 전역 패턴을 확장합니다. 기본 제공 기본값을 제거할 수는 없습니다.
스킬
다음으로 설치합니다:
npx skills add scchearn/hcom-mcp운영 지침은 skills/에 포함되어 있습니다:
skills/using-hcom/SKILL.md— 메시징, 스레드, 트랜스크립트, 이벤트 감시skills/hcom-agent-messaging/SKILL.md— 에이전트 간 메시징 패턴 및 주의 사항
도구
도구 | 용도 |
| 헤드리스 에이전트 실행(프리셋 또는 기본 harness+model) |
| 실행 + 준비 상태 게이트, 차단된 에이전트의 선택적 보호 구조 포함 |
| 토폴로지 프리셋에서 여러 에이전트 실행(선택적 |
| 외부 hcom 에이전트를 관리형 수명주기로 채택 |
| 관리형 에이전트 중지 또는 종료(이름 하나 이상 또는 태그) |
| 차단된 에이전트에 대한 보호 PTY 구조(기본적으로 드라이런, 구성 허용 목록) |
| 소유 에이전트 감독: 파생 플래그가 있는 스냅샷 폴링 또는 life/blocked 이벤트 구독 |
| 중지된 에이전트 재개 또는 세션 포크, |
| 하나 이상의 에이전트에 hcom 메시지 전송(request/inform/ack, 선택적 reply_to) |
| 이 서버가 관리하는 에이전트 나열 |
| 실행 중인 모든 hcom 에이전트 나열 |
| harness별 사용 가능한 모델 나열(claude 전체 ID는 검증 없이 통과) |
| 구성된 에이전트 프리셋 나열 |
| 구성된 토폴로지 프리셋 나열 |
| 에이전트의 상태, 트랜스크립트, 이벤트 또는 터미널 검사 |
| 에이전트 트랜스크립트, 트랜스크립트 검색 결과 또는 트랜스크립트 타임라인 읽기 |
| 실행 중이거나 중지된 에이전트에서 핸드오프 컨텍스트 가져오기 |
| 오래된 레지스트리 레코드 제거 |
| 워크플로 스레드 생성 |
| 스레드 이벤트 조회 |
| 서버 상태 및 오리엔테이션( |
라이선스
MIT
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessResponsive
Related MCP Connectors
Hosted MCP memory and agent control plane for durable conversations, jobs, and operations.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP-first control plane for ProAgentStore agents and private instances.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceMCP server orchestrating local multi-agent workflows with gated lifecycle, handoff events, and host-level continuation.-
- FlicenseAqualityCmaintenanceMCP server for controlling a Hermes agent deployment via its HTTP API, enabling health checks, log retrieval, task management, and deployment configuration from MCP clients.17-
- AlicenseNot gradedqualityAmaintenanceA self-hosted MCP control plane and protocol gateway that aggregates and manages multiple MCP servers, exposing them via stable, authenticated MCP endpoints for any client.01MIT