🛠️ mcp-opentym

A lightweight Model Context Protocol (MCP) HTTP server built with the official Python MCP SDK and Streamable HTTP transport. Designed to give AI assistants (Claude, Cursor, etc.) real tools to interact with your Windows machine.

✨ Features

🚀 Quick Start

1. Clone & setup

git clone https://github.com/doanhtuan123/mcp-server-python.git
cd mcp-server-python
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium

2. Run the server

python server.py

Server starts at: http://localhost:3458/mcp Health check: http://localhost:3458/health

3. Public tunnel (optional)

Expose locally via Cloudflare Quick Tunnel:

python tunnel.py

The public URL is saved to data/tunnel-url.txt.

⚙️ Configuration

To change the port, edit the port= value near the bottom of server.py.

📦 Dependencies

mcp[cli]>=1.0.0
httpx>=0.27.0
beautifulsoup4>=4.12.0
playwright>=1.44.0

🔌 Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-opentym": {
      "url": "http://localhost:3458/mcp"
    }
  }
}

Or with the public tunnel URL:

{
  "mcpServers": {
    "mcp-opentym": {
      "url": "https://<your-tunnel>.trycloudflare.com/mcp"
    }
  }
}

🗂️ Project Structure

mcp-server-python/
├── server.py          # Main MCP server
├── tunnel.py          # Cloudflare Quick Tunnel helper
├── requirements.txt   # Python dependencies
├── data/              # Runtime data (logs, tunnel URL)
└── workspace/         # Shared file workspace for tools

📄 License

MIT