GitHub MCP 레지스트리를 Naftiko Capability 로 감싸기 — 하나의 스펙에서 REST, MCP, 에이전트 기술까지

GitHub MCP 레지스트리는 존재합니다. 이는 이제 실제 인프라의 일부가 되었으며, 벤더들이 여기에 게시하고 기업들이 이를 거울 (mirror) 로 사용하며, IDE 들이 발견을 위해 이를 가리키기 시작했습니다. 오늘날 개발자로서 레지스트리의 문제는 웹페이지를 스크롤해야 한다는 점입니다. 에이전트는 이를 잘못 읽습니다. 보안 팀은 수동으로 쿼리를 수행합니다. 플랫폼 자동화는 이를 도구처럼 호출할 수 없으며, 메타데이터의 JSON 카탈로그와 키워드 검색처럼 보이기 때문입니다. 이 글은 공학적 관점에서의 논증입니다: 레지스트리를 Naftiko Capability 로 감싸고 하나의 스펙에서 세 가지 표면을 노출하며, 모든 소비자 (인간, 에이전트, 파이프라인) 가 동일한 방식으로 호출할 수 있는 것으로 만듭니다.

Naftiko Capability 의 형태
Naftiko capability YAML 은 두 가지 사항을 선언하는 단일 아티팩트입니다:

• consumes: Capability 가 호출하는 업스트림 API
• exposes: Capability 가 외부로 제공하는 표면 (REST, MCP, Agent Skills)

Naftiko Engine 은 스펙을 실행합니다. 동일한 아티팩트가 배포 단위, 문서화, 거버넌스 계약입니다. 스펙은 런타임에서 벗어나지 않습니다. 왜냐하면 스펙 자체가 런타임 아티팩트이기 때문입니다. 프레임워크 위키에는 Spec-Driven Integration 에 대한 장문의 논증이 있습니다.

GitHub MCP 레지스트리의 경우 Capability 의 형태는 대략 다음과 같습니다:

naftiko:
"1.0.0-alpha2"
info:
name: github-mcp-registry-discovery
description: Conversational discovery surface over the GitHub MCP Registry
version: "1.0.0"
consumes:
github-registry:
type: http
baseUrl: https://api.github.com
auth: github_app_installation
operations:
list-registry-entries:
method: GET
path: /repos/{{ .registry_owner }}/{{ .registry_repo }}/contents/servers
get-registry-entry:
method: GET
path: /repos/{{ .registry_owner }}/{{ .registry_repo }}/contents/servers/{{ .entry_path }}

이는 consume 측면입니다. Capability 는 이제 GitHub Contents API 를 통해 레지스트리를 읽을 수 있습니다.

다음 블록은 대화형 발견 (conversational discovery) 이 구현되는 exposes 측면입니다. 세 가지 노출, 하나의 스펙:

exposes:
rest:
operations:
find-mcp-servers:
method: GET
path: /v1/mcp-servers
parameters:
- name: purpose
in: query
schema:
type: string
- name: vendor
in: query
schema:
type: string
- name: review_status
in: query
schema:
type: string
enum: [approved, pending, revoked]
outputParameters:
- name: servers
type: array
jsonpath: $.results[]
items:
- name: urn
jsonpath: $.urn
- name: install_url
jsonpath: $.install.url
- name: scopes
jsonpath: $.install.scopes[]
- name: review_status
jsonpath: $.governance.review.status
- name: review_date
jsonpath: $.governance.review.date
mcp:
transport: streamable-http
tools:
find-mcp-servers:
description: Find MCP servers in the registry filtered by purpose, vendor, or review status
inputSchema:
type: object
properties:
purpose:
type: string
description: "What task the agent needs the server for"
vendor:
type: string