MockMCP
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/mcpCursor — ~/.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를 기본적으로 지원합니다.
도구
도구 | 기능 |
| 모의 사용자 페이지 목록 |
| ID 또는 시드로 모의 사용자 하나 가져오기 |
| 모의 사용자 생성 (지속성 없음) |
| 모의 제품 페이지 목록 |
| 모의 제품 하나 가져오기 |
| 선택적 상태 필터가 포함된 모의 주문 목록 |
| 모의 주문 하나 가져오기 |
| 모의 주문 생성 (지속성 없음) |
| 모의 분석 이벤트 |
| 모의 이벤트 기록 |
| 가짜 성공 응답 반환 (실제 발송 안 됨) |
| 순위가 매겨진 결과가 포함된 모의 지식 베이스 검색 |
모든 데이터는 입력값에 따라 시드(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을 통해 설정됩니다.
이 저장소를 포크하고 GitHub에 푸시합니다.
Railway → 새 프로젝트(New Project) → GitHub에서 배포(Deploy from GitHub) → 포크한 저장소 선택.
Railway → 변수(Variables)에 환경 변수 추가:
변수 | 참고 |
| upstash.com 무료 티어에서 확인 |
| 위 URL과 쌍을 이룸 |
| Railway가 자동으로 설정 |
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를 참조하세요.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Email inboxes, webhook URLs, mock APIs and 170+ tools for coding agents over one MCP connection.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides seamless access to the Fake Store API for AI assistants with 18 CRUD tools for managing e-commerce data including products, carts, and users. Perfect for e-commerce demos, testing, and learning MCP development with zero configuration required.185 npmMIT
- AlicenseBqualityBmaintenanceUnified MCP gateway for AI agents with 56+ tools and growing. Travel (Amadeus, Sabre GDS), e-commerce, local services, financial markets (Polymarket), and marketing APIs — all through a single endpoint. Pay-per-call via x402 micropayments in USDC.50010MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with 220+ tools for building websites, sending email, managing contacts, invoicing, databases, automation, and more through a single secure connection. Features hardware-bound authentication and works with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query keyless mock REST data — products, users, posts, comments, recipes, quotes, and todos — with search, paging, and field selection for prototyping, demos, and test scaffolds. Offers a gateway-hosted or local stdio MCP endpoint plus plain-HTTP tool calls, requiring no API key or account for initial use.88 npmMIT