MCP 서버 디렉토리 구축: 기술적 심층 분석

Model Context Protocol (MCP)는 AI 에이전트를 외부 도구에 연결하는 표준으로 빠르게 자리 잡고 있습니다. 하지만 생태계가 성장함에 따라, 개발자들은 프로덕션(production) 사용 전에 MCP 서버를 발견하고, 테스트하고, 검증할 수 있는 방법이 필요합니다. 이것이 바로 우리가 MCP Workbench에서 MCP 서버 디렉토리 API를 구축한 이유입니다.

이 포스트에서는 실제 엔드포인트(endpoint), 실제 응답, 그리고 자격 증명(credentials) 없이 MCP 연결을 시뮬레이션하는 테스트 모드(test mode) 기능을 통해 디렉토리 API가 정확히 어떻게 작동하는지 보여드리겠습니다.

MCP 서버 디렉토리 API

이 디렉토리는 읽기 작업에 인증이 필요하지 않은 공개 REST API입니다. 기본 URL은 다음과 같습니다:

Local:  http://localhost:3460
Prod:   https://mcp-workbench.uk

서버 목록 조회 (Listing Servers)

GET /api/mcp-servers

curl "http://localhost:3460/api/mcp-servers?limit=3"

응답(Response):

{
  "servers": [
    {
...

카테고리별 필터링 (Filtering by Category)

curl "http://localhost:3460/api/mcp-servers?category=security"

사용 가능한 카테고리: ai-ml, browser-automation, database, development, filesystem, http, integration, observability, search, security

서버 상세 정보 가져오기 (Getting Server Details)

GET /api/mcp-servers/{slug}

curl "http://localhost:3460/api/mcp-servers/playwright-mcp"

응답(Response):

{
  "id": 1,
  "name": "Playwright MCP",
...

테스트 모드: 자격 증명 없이 연결 시뮬레이션하기

이것은 개발자들이 가장 많이 요청하는 기능입니다. 자격 증명과 설정에 시간을 들이기 전에 MCP 서버가 제대로 작동하는지 어떻게 확인할 수 있을까요?

/test-mode 엔드포인트는 전체 MCP 연결 핸드셰이크(handshake)를 시뮬레이션합니다:

GET /api/mcp-servers/{slug}/test-mode

curl "http://localhost:3460/api/mcp-servers/playwright-mcp/test-mode"

응답(Response):

{
  "server_id": "playwright-mcp",
  "test_mode": true,
...

테스트 모드는 네 가지 중요한 차원을 검증합니다:

1. Startup (시작) — 서버 프로세스를 실행할 수 있는가?
2. Initialization (초기화) — JSON-RPC 핸드셰이크 (handshake)가 성공하는가?
3. Tool Discovery (도구 탐색) — 도구들이 적절하게 광고(advertise)되는가?
4. Schema Validation (스키마 검증) — 도구 스키마 (schema)가 올바른 형식인가?

디렉토리에 서버 추가하기

인증된 사용자는 POST /api/mcp-servers를 통해 서버를 추가할 수 있습니다:

curl -X POST "http://localhost:3460/api/mcp-servers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
...

요청 본문 (Request body) 필드:

CCS 검증 배지

Correctover Conformity Check (CCS)를 통과한 서버는 검증 배지를 받게 됩니다:

<img src="/api/integrations/ccs/badge/mw-ccs-a1b2c3d4e5f6" alt="CCS Protocol Compliant"/>

배지는 색상으로 구분됩니다:

• 녹색 (≥90%) — 준수 (Compliant)
• 노란색 (≥70%) — 조건부 (Conditional)
• 빨간색 (<70%) — 검토 필요 (Review Needed)

속도 제한 (Rate Limits)

• 공개 (Public): IP당 60초당 100회 요청
• 인증됨 (Authenticated): 제한 없음

다음 단계는?

MCP Workbench 디렉토리는 성장하는 MCP 서버 생태계를 위해 설계되었습니다. 여러분이 다음과 같은 상황에 처해 있더라도:

• 새로운 MCP 서버를 구축하고 초기 피드백을 원하는 경우
• 기존 서버를 유지 관리하며 검증을 원하는 경우
• 특정 카테고리의 서버를 찾고 있는 경우

...디렉토리 API는 여러분에게 생태계에 대한 프로그래밍 방식의 접근 권한을 제공합니다.

라이브 사이트: https://mcp-workbench.uk

API 문서: https://mcp-workbench.uk/api-docs

GitHub: https://github.com/mcp-workbench/mcp-workbench