Model Context Protocol (MCP) Example

by iddv

7 183 downloads Not rated yet MIT license

GitHub Website

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

License: MIT license

Explore

The ultimate demonstration of AI logical reasoning!

```bash

- Multiple Transports: stdio, HTTP, WebSocket ready
- Session Management: Multiple concurrent games
- Real-time Updates: Live game state streaming
- Authentication Ready: OAuth 2.0 support built-in
- Statistics: Global leaderboards and analytics

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

- Python 3.10+ (FastMCP 2.0 requirement)
- Poetry (recommended) or pip

poetry install

- 📄 template_server.py - Clean starting canvas with all boilerplate
- 🎮 minesweeper_server.py - Complex working example to learn from
- 📚 Complete Guides - Step-by-step instructions and patterns

python @mcp.set_auth_config def auth_config(): return { "authorization_url": "https://your-auth.com/oauth/authorize", "token_url": "https://your-auth.com/oauth/token", "client_id": os.getenv("CLIENT_ID"), "scopes": ["read", "write", "admin"] } ```

mcp install examples/servers/minesweeper_server.py

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.

About

Details

Explore

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

More like this

Sentry

Github

Git

GitLab