MCPMock - Examples & Showcase

Welcome to the MCPMock Examples Repository! This repository showcases the capabilities of mcpmock.ai, a powerful mock server implementing the Model Context Protocol (MCP).

🌟 What is MCPMock?

MCPMock is a full-featured Model Context Protocol (MCP) mock server used for developing, testing, and debugging MCP clients and AI agents. It provides mock MCP tools, mock responses, and dynamic tool simulations for developers building LLM-based applications, agent frameworks, or MCP integrations.

MCPMock helps you:

• Test AI integrations without depending on real services
• Develop MCP clients with realistic mock responses
• Create dynamic mock tools with templates, sequences, and functions
• Prototype quickly with configurable mock behaviors

Try it live: https://www.mcpmock.ai

🚀 Quick Start

1. Sign Up

Visit mcpmock.ai and sign up using Google, GitHub, or GitLab OAuth.

2. Get Your API Token

After logging in, navigate to the Settings tab to find your API token.

3. Get Your MCP Server Endpoint

Your unique MCP server endpoint URL is available in:

• The Dashboard in the MCPMock UI
• Or via API call: GET https://api.mcpmock.ai/me/endpoint (requires authentication)

The endpoint format is: https://mcp.mcpmock.ai/{your-server-id}/

Example: https://mcp.mcpmock.ai/0123456-1234-5678-90ab-1234567890ab/

4. Create Your First Mock Tool

curl -X POST https://api.mcpmock.ai/tools \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "get_weather",
    "description": "Get weather information for a location",
    "inputSchema": {
      "type": "object",
      "properties": {
        "location": {"type": "string"}
      },
      "required": ["location"]
    },
    "mockResponse": {
      "type": "static",
      "data": {
        "temperature": 72,
        "condition": "sunny",
        "humidity": 45
      }
    }
  }'

5. Use the MCP Protocol

Note: MCP endpoints don't require authentication. Replace YOUR_MCP_SERVER_ID with your actual server ID from the dashboard.

# Initialize the connection
curl -X POST https://mcp.mcpmock.ai/YOUR_MCP_SERVER_ID/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

# List available tools
curl -X POST https://mcp.mcpmock.ai/YOUR_MCP_SERVER_ID/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list"
  }'

# Call your tool
curl -X POST https://mcp.mcpmock.ai/YOUR_MCP_SERVER_ID/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_weather",
      "arguments": {"location": "San Francisco"}
    }
  }'

📚 Examples Library

Basic Examples

• Authentication Flow - OAuth login and token management
• Static Mock Responses - Simple fixed responses
• Template Responses - Dynamic responses using input parameters

Advanced Examples

• Sequence Responses - Return different responses on each call
• Function Responses - JavaScript functions for complex logic
• Admin API - Full CRUD operations on mock tools
• Error Handling - Working with errors and edge cases

Integration Examples

• Python Client - Using MCPMock with Python
• Node.js Client - Using MCPMock with Node.js
• Testing Frameworks - Integration with Jest, Pytest, etc.

🎓 Tutorials

1. Getting Started - Complete walkthrough for new users
2. Creating Dynamic Tools - Build tools that respond intelligently
3. Testing AI Applications - Use MCPMock in your test suite
4. Building MCP Clients - Develop clients using MCPMock

🎯 Use Cases

• AI Agent Development: Test your agents against controlled mock services
• MCP Client Testing: Validate protocol implementation without real servers
• API Prototyping: Mock APIs before backend implementation
• Integration Testing: Reliable test fixtures for CI/CD pipelines
• Training & Demos: Consistent environments for workshops and demos

📖 Documentation

For comprehensive documentation, visit the main repository.

🛠️ Mock Response Types

MCPMock supports four powerful mock response types:

Static

Fixed responses that never change:

{
  "type": "static",
  "data": {"result": "Hello, World!"}
}

Template

Dynamic responses using input parameters:

{
  "type": "template",
  "template": "Hello, {{name}}! Temperature is {{input.temp}}°F"
}

Sequence

Different responses for each call:

{
  "type": "sequence",
  "responses": [
    {"data": {"status": "pending"}},
    {"data": {"status": "processing"}},
    {"data": {"status": "complete"}}
  ]
}

Function

JavaScript functions for complex logic:

{
  "type": "function",
  "code": "function(input) { return { result: input.a + input.b }; }"
}

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

📝 License

This examples repository is licensed under the MIT License. See LICENSE for details.

The MCPMock platform itself is proprietary software. Visit mcpmock.ai for terms of service.

🔗 Resources

• Website: https://www.mcpmock.ai
• Main Repository: https://github.com/AratoAi/mcp-mock-server
• Support: Open an issue in this repository

⭐ Show Your Support

If you find MCPMock useful, please star this repository and share it with others!

Built with ❤️ by Arato AI