mcp-opentym

🛠️ 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

| Tool | Description | |------|-------------| | exec | Run shell commands (cmd / PowerShell) | | read_file | Read files with offset/limit pagination | | write_file | Write or append to files | | list_files | List directory contents | | open_app | Open applications or URLs | | get_system_info | CPU, RAM, disk, network info | | screenshot | Capture the screen | | clipboard | Read or write clipboard | | send_notification | Windows toast notifications | | web_search | Search the web via Brave API | | web_fetch | Fetch and extract content from URLs | | http_request | Generic HTTP client (GET/POST/etc.) | | get_datetime | Current date & time | | calculate | Safe math expression evaluator | | get_weather | Weather by city name | | browser_action | Full browser automation via Playwright | | memory_search | Semantic search over memory files | | memory_get | Read memory file snippets | | memory_write | Append or write memory files |

---

🚀 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

| Item | Default | |------|---------| | Port | 3458 | | Transport | Streamable HTTP | | Browser | Chrome (Playwright) | | Shell | cmd / powershell |

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