MockMCP

에이전트 프로토타이핑을 위해 사실적인 가짜 데이터를 반환하는 호스팅된 MCP 엔드포인트입니다. URL 하나만 붙여넣으면 설정이 완료됩니다.

라이브 사이트 mockmcp.io — https://mockmcp.io/mcp

백엔드 연결, 픽스처 작성 또는 로컬 MCP 서버 구축 없이 에이전트 워크플로우를 프로토타이핑하려는 개발자를 위해 제작되었습니다. 대부분의 에이전트 튜토리얼에서 다루는 시나리오를 포함하는 12개의 사전 구축된 도구가 제공됩니다.

사용해 보기

# Initialize a session and get back a session id
curl -i -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

# Use the Mcp-Session-Id header in subsequent calls:
curl -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <paste-id-here>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_users","arguments":{"limit":3}}}'

Related MCP server: APIbase

클라이언트 연결

Claude Code

claude mcp add --transport http mockmcp https://mockmcp.io/mcp

Cursor — ~/.cursor/mcp.json에 추가:

{
  "mcpServers": {
    "mockmcp": {
      "url": "https://mockmcp.io/mcp"
    }
  }
}

Claude Desktop — 설정(Settings) → 커넥터(Connectors) → 사용자 지정 커넥터 추가(Add custom connector) → URL에 https://mockmcp.io/mcp를 붙여넣으세요.

mcp-remote 프록시가 필요하지 않습니다. 세 클라이언트 모두 Streamable HTTP를 기본적으로 지원합니다.

도구

모든 데이터는 입력값에 따라 시드(seed)가 생성되므로, 동일한 입력에는 동일한 출력이 반환됩니다.

제한 사항

해시된 IP + User-Agent 지문당 무료 티어 제한:

• 분당 30회 요청

• 일일 500회 요청

제한에 도달했나요? mockmcp.io/waitlist에 이메일을 남겨주시면 유료 티어 출시 시 안내해 드립니다.

429 응답에는 upgrade_url 및 retry_after_seconds가 포함된 구조화된 JSON-RPC 오류가 포함됩니다. 모든 성공적인 응답에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 및 X-RateLimit-Scope 헤더가 포함됩니다.

로컬 실행

npm install
npm run dev

서버는 http://localhost:3000에서 수신 대기합니다. MCP 엔드포인트는 /mcp에 있습니다. Upstash 환경 변수가 없으면 속도 제한은 인메모리 저장소(프로세스별, 개발용으로 적합)로 대체됩니다.

스택

• @modelcontextprotocol/sdk — MCP 서버 + Streamable HTTP 전송

• Raw Node http — 프레임워크 오버헤드 없음, 깔끔한 종료

• @faker-js/faker — 시드를 통한 결정론적 가짜 데이터 생성

• @upstash/ratelimit + @upstash/redis — 슬라이딩 윈도우 속도 제한

• zod — 도구 입력 유효성 검사

배포 (포크용)

Node 20+를 대상으로 합니다. 빌드 및 시작은 nixpacks.toml에 고정되어 있으며, 상태 확인 및 재시작 정책은 railway.json을 통해 설정됩니다.

1. 이 저장소를 포크하고 GitHub에 푸시합니다.

2. Railway → 새 프로젝트(New Project) → GitHub에서 배포(Deploy from GitHub) → 포크한 저장소 선택.

3. Railway → 변수(Variables)에 환경 변수 추가:

4. Railway 서비스 → 설정(Settings) → 네트워킹(Networking) → 사용자 지정 도메인(Custom Domain) → 도메인 붙여넣기 → DNS 지침을 따르세요.

상태 확인

GET /health는 {"ok":true}를 반환합니다. Railway는 배포 중에 이를 핑(ping)합니다.

대기자 명단 등록

POST /api/waitlist는 등록당 구조화된 JSON 라인을 기록합니다:

{"event":"waitlist_signup","email":"alice@example.com","at":"2026-04-24T19:33:06.396Z"}

railway logs | grep waitlist_signup으로 로그를 확인하세요. 설계상 저장소가 필요 없으며, 유료 티어 출시 시 Resend, Tally 포워더 또는 DB로 교체할 수 있습니다.

라이선스

MIT — LICENSE를 참조하세요.