Model Context Protocol (MCP) Example

by iddv

7 stars

183 downloads

Not rated

GitHub

Developer Tools

About

A reference implementation of the Model Context Protocol (MCP) enabling seamless tool calling between LLMs and applications. Features client/server architecture with HTTP APIs, local CLI execution, and AWS Bedrock integration in a production-ready, extensible framework.

Details

Author: iddv
GitHub stars: 7
Downloads: 183
Categories: Developer Tools

- Living Minesweeper example demonstrating AI logical reasoning
- Multiple transport protocols: stdio, HTTP, WebSocket
- Session management for concurrent game instances
- OAuth 2.0 authentication ready
- Real-time data streaming and game state resources
- Strategy guides, pattern library, and AI prompts

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Model Context Protocol (MCP) Example

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

From the repository

Clone the repository and install dependencies using Poetry (poetry install) or pip (pip install -e .). Start the Minesweeper server in development mode with mcp dev examples/servers/minesweeper_server.py or as an HTTP server with python examples/servers/minesweeper_server.py --transport http --port 8000. For production, configure transport via mcp.run(transport="streamable-http") or mcp.run(transport="websocket"). Test servers interactively using mcp dev or programmatically with the built-in testing module.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "model context protocol (mcp) example": {
            "mcp-example": {
                "command": "python",
                "args": [
                    "examples/servers/minesweeper_server.py",
                    "--transport",
                    "http",
                    "--port",
                    "8000"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-example": {
        "command": "python",
        "args": [
            "examples/servers/minesweeper_server.py",
            "--transport",
            "http",
            "--port",
            "8000"
        ]
    }
}

🎯 MCP Examples - Enterprise Edition

> 🚀 FastMCP 2.0 powered examples for building sophisticated Model Context Protocol servers

Welcome to the ultimate MCP examples repository! Build enterprise-grade AI servers with our living Minesweeper example and comprehensive FastMCP 2.0 templates.

✨ What's New in This Edition

🎮 Living Game Example: Watch LLMs master Minesweeper through logical reasoning
🚀 FastMCP 2.0: Enterprise features with multiple transport protocols
🏢 Production Ready: Authentication, sessions, real-time data, WebSocket support
🤖 AI Agent Friendly: Complete templates and guides for automated server generation

🎯 Featured: Minesweeper MCP Server

The ultimate demonstration of AI logical reasoning!

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Model Context Protocol (MCP) Example

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

🎯 MCP Examples - Enterprise Edition

✨ What's New in This Edition

🎯 Featured: Minesweeper MCP Server

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🎯 MCP Examples - Enterprise Edition

✨ What's New in This Edition

🎯 Featured: Minesweeper MCP Server

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright