mcp-server-example

A learning repository for Model Context Protocol's server-side via Python.

Catalog onlyCatalog onlySTDIO

Overview

The mcp-server-example is a learning repository designed to help developers understand and implement the Model Context Protocol on the server-side using Python.

To use this repository, clone it from GitHub and follow the provided documentation to set up the server and explore the examples provided.

Comprehensive examples of Model Context Protocol implementation in Python. - Easy-to-follow documentation for setup and usage. - Open-source and community-driven contributions.

Learning how to implement server-side protocols in Python.
Experimenting with Model Context Protocol for educational purposes.
Contributing to open-source projects related to server-side programming.

Add to your AI client

Use these steps to connect mcp-server-example in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-example-ziyacivan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-example-ziyacivan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-example-ziyacivan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-example-ziyacivan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-example-ziyacivan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-example-ziyacivan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-ziyacivan"
      ]
    }
  }
}

FAQ

Is this repository suitable for beginners?

Yes! It is designed to help learners understand server-side programming concepts.

Can I contribute to this project?

Absolutely! Contributions are welcome, and you can submit pull requests on GitHub.

What programming language is used in this project?

The project is implemented in Python.

Developer tools