Skip to main content
Glama

A minimal MCP server built from scratch — no SDK.

Implements the Model Context Protocol (2025-03-26) over both Streamable HTTP and WebSocket, with a clean separation between transport, protocol, registry, and execution layers.

Related MCP server: Modular MCP Server

Tools

Tool

Description

shell

Run a shell command

readfile

Read a file from disk

writefile

Write a file to disk

fetch

Fetch a URL

Quickstart

uv sync
python serve.py

Connect via MCP Inspector:

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP → http://127.0.0.1:8000/mcp
# Transport: WebSocket       → ws://127.0.0.1:8000/ws

Architecture

Transport and protocol are fully decoupled. Both HTTP and WebSocket adapters call the same dispatch() — adding a new transport means writing a thin adapter, not touching protocol logic.

Tool isolation is set per-tool: shell runs in an isolated subprocess with a timeout; trusted tools run inline.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A simple MCP Server with shell execution capabilities that can be run locally with Ngrok tunneling or hosted in an Ubuntu 24 Docker container.
    4
    MIT
  • F
    license
    B
    quality
    D
    maintenance
    A config-driven, zero-dependency MCP server with plugin architecture that enables filesystem operations, shell commands, HTTP requests, and utilities through simple JSON configuration.
    3
    1
    -
  • A
    license
    A
    quality
    D
    maintenance
    A Python MCP server implemented from scratch, providing tool execution capabilities like system time and file hashing via stdio or HTTP transport.
    2
    1
    MIT