DeepSeek Capability Hub

Capability Hub는 DeepSeek Harness 및 기타 MCP 클라이언트를 위한 지연 실행(lazy) MCP·스킬 브로커입니다. 호스트는 설정된 모든 서버의 모든 툴 스키마가 차지하는 컨텍스트 비용을 지불하는 대신, capability_hub라는 하나의 컴팩트한 툴만 마주하게 됩니다.

에이전트는 간결한 카탈로그를 검색하고, 권한을 확인하고, 신뢰하는 서버 하나를 구동한 뒤 허브를 통해 호출하고 다시 종료할 수 있습니다. 스킬 본문은 선택된 후에만 로드됩니다.

존재 이유

대규모 정적 MCP 설정은 컨텍스트를 낭비하고 툴 선택을 더 어지럽게 만듭니다. Capability Hub는 모델에 노출되는 표면을 안정적으로 유지합니다.

search → inspect → enable → tools → call → disable

• 하나의 고정된 스키마만 Harness 프롬프트에 유지됩니다.

• 하위 툴 스키마는 요청되기 전까지 모델 컨텍스트 밖에 남습니다.

• tools는 기본적으로 이름과 설명만 반환하며, 전체 스키마는 선택 사항입니다.

• MCP 프로세스는 지연 실행되며 허브 프로세스 수명 동안만 활성 상태로 남습니다.

• 스킬은 메타데이터로 검색된 뒤 하나씩 로드됩니다.

• 제3자 추가분은 사람의 승인 대기열로 들어가며, 모델이 실행 가능한 코드를 스스로 승인할 수는 없습니다.

Related MCP server: capability-router

빠른 시작

요구 사항: Node.js 22.19+ 및 pnpm.

git clone https://github.com/NeoXider/deepseek-capability-hub.git
cd deepseek-capability-hub
pnpm install --frozen-lockfile
pnpm test
pnpm client -- --json '{"action":"search","query":"demo"}'

기본 카탈로그에는 번들로 제공되는 echo MCP와 예제 ML 스킬만 포함됩니다. 테스트는 제3자 패키지를 다운로드하거나 실행하지 않습니다.

DeepSeek Harness 설정

허브를 빌드한 다음, examples/dsh/cordis.patch.yml을 활성 Harness Web 프로필에 병합하고 절대 저장소 경로를 조정합니다. 그다음 Harness를 다시 시작합니다.

pnpm build

Harness는 모델에 노출하는 툴 하나를 제공합니다.

mcp__capability_hub__capability_hub

시작하기:

{"action":"search","query":"web research"}

모델 노출 계약

공개 스키마는 의도적으로 평면 구조로 설계되어 LM Studio 같은 constrained-decoding 엔진도 안정적으로 컴파일할 수 있습니다. 임의의 하위 인자는 JSON 문자열로 전달됩니다.

툴 검색 및 호출:

{"action":"tools","name":"web-search-neo"}

{
  "action": "call",
  "name": "web-search-neo",
  "tool": "web_info",
  "argumentsJson": "{\"topic\":\"search_status\"}"
}

사용 가능한 액션:

실제 통합 예시

검토 준비가 된 제안이 다음 항목으로 포함되어 있습니다.

• Web Search Neo — 동적 웹 조사 및 브라우저 툴링.

• Unity CLI MCP — 공식 Unity CLI 전송. Unity Pipeline이 포함된 Unity Editor가 연결된 동안에만 툴 목록이 채워집니다.

이 파일들은 예시일 뿐이며, 별도 확인 없이 신뢰되는 기본값이 아닙니다. 승인하기 전에 경로, 버전, 권한을 검토하세요.

사람 승인 기반 설치

모델이 생성한 제안은 data/state/pending 아래 저장되며 실행될 수 없습니다. 사람이 직접 조작하는 별도의 명령줄에서 승인하세요.

node dist/src/admin.js approve <proposal-id> --state .\data\state --yes

그다음 catalog.reload와 enable을 호출합니다. 승인 항목에는 버전 고정(pinned) 패키지 또는 변경 불가능한 Git 리비전을 권장하며, 떠도는 latest 설치 방식은 피하세요.

카탈로그, 비밀값, 스킬

• MCP 전송: stdio 및 streamable-http.

• 템플릿: ${catalogDir}, ${packageDir}, 그리고 명시적으로 허용된 ${config:key} 값.

• 비밀값: 환경 변수 참조만 허용. 비밀값 형태의 모델 구성 키는 거부됨.

• 스킬: 승인된 로컬 Markdown 파일이 온디맨드로 로드되며 256 KiB로 제한.

• 상태: 런타임 구성과 제안은 Git에서 무시됩니다.

신뢰 경계에 관해서는 SECURITY.md를 참조하세요.

현재 범위

• 툴 호출은 프록시됩니다. 하위 MCP 리소스와 프롬프트는 아직 브리지되지 않았습니다.

• 재연결은 명시적 방식입니다. disable 후 enable 순서로 이뤄집니다.

• 원격 스킬 다운로드, 서명 검증, 샌드박스 설치 프로그램은 추후 작업입니다.

• 호스트 셸에 제한 없이 접근할 수 있는 모델은 플러그인 로컬 정책을 우회할 수 있습니다. 따라서 Harness 권한으로 외곽 경계를 삼으세요.

함께 보면 좋은 프로젝트

에이전트, 컨텍스트, 모델, 추론, 대화를 컴팩트한 애니메이션 데스크톱 뷰로 보고 싶나요? DeepSeek Harness Widget을 확인해 보세요.

기여

이슈와 명확한 목적을 갖춘 Pull Request는 언제나 환영입니다. 새 통합에는 버전이 고정된 예시, 범위가 좁은 권한 설명, 그리고 엔드투엔드 테스트가 포함되어야 합니다.

MIT © NeoXider